briefd

briefd — MCP-сервер сообщества (автор — ismailperim). Командные знания из Git, собранные в компактные пакеты контекста для ИИ-агентов. Ставится через npx. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
ismailperim
Лицензия
Apache-2.0
Транспорт
streamable_http
Авторизация
api_key
ОС
Не указана
Языки
go

Уровень риска: high

Контекст по запросу из базы знаний в git с бюджетом токенов; агент предлагает правки через PR.

Настройка клиентов

claude-code
{
    "code": "claude mcp add --transport http briefd http://localhost:7788/mcp \\\n  --header \"Authorization: Bearer dev-token\"",
    "lang": "sh",
    "verified": "docs"
}

Что умеет

briefd — самостоятельно размещаемый «компилятор контекста» для команд, которые пишут код с ИИ-агентами. Знания команды — терминология, бизнес-правила, архитектурные решения, соглашения — хранятся как Markdown в git-репозитории. briefd индексирует их и отвечает агенту на один вопрос: «что мне нужно знать для этой задачи?» — собранным пакетом без дублей, который никогда не превышает заданный бюджет токенов. Идея — контекст по запросу вместо загрузки всего CLAUDE.md или AGENTS.md в каждую сессию.

По замерам автора на учебной базе (44 документа, 47 задач) compile_bundle тратит на 86% меньше токенов, чем вставка всего в CLAUDE.md, и в 96% случаев содержит нужный раздел. В реальных сессиях Claude Code на 10 задачах контекст на шаг сократился на 35%, стоимость задачи — на 40% при тех же ответах, ценой 3–4 дополнительных вызовов инструментов.

Чем отличается от памяти агента: briefd отдаёт то, что решила команда, написанное людьми и проверенное как код. Агенты не пишут в индекс — propose_update открывает ветку или pull request, и изменения попадают в выдачу только после слияния человеком. Поиск гибридный и без внешних сервисов: SQLite FTS5 плюс многоязычные эмбеддинги multilingual-e5-small (100+ языков) на чистом Go.

Инструменты:

Инструмент Что делает
compile_bundle Один пакет контекста в пределах бюджета: домен, соглашения, проект, со ссылкой на источник каждого раздела
search_context Ранжированные разделы для просмотра
get_document Документ целиком со ссылками и обратными ссылками
list_scopes Области с числом документов
propose_update Ветка briefd/proposal-…, при настройке — pull request
report_usage Отзыв: какие разделы помогли; пустой список отмечает пробел в знаниях
suggest_links Недостающие и битые ссылки

При настройке Confluence и Jira Cloud добавляются по два инструмента поиска и чтения для каждого.

Кому подойдёт

Командам, которые ведут много проектов в одной предметной области и хотят, чтобы все агенты применяли одни и те же правила. Похожие серверы — в категории знания и память.

Установка

Попробовать можно за полминуты: briefd demo поднимает встроенную учебную базу на http://127.0.0.1:7788. Первый запуск скачивает модель эмбеддингов (около 470 МБ); --embeddings none это пропускает. Для своей базы соберите бинарник (Go 1.26+) или возьмите его из релизов и запустите briefd serve --source с адресом репозитория и токеном. Есть образ Docker (около 34 МБ). Репозиторий с базой создаётся командой briefd init и состоит из папок domain/, conventions/ и projects/; подходят и хранилища Obsidian.

Подключение к клиентам

Конфигурации из README: Claude Code по HTTP к общему серверу и Claude Desktop с локальным запуском по stdio. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport http briefd http://localhost:7788/mcp \
  --header "Authorization: Bearer dev-token"

Режим briefd mcp по stdio даёт те же инструменты без порта и токена — для одного пользователя. Каждый сервер также отдаёт страницу /setup с готовыми шагами для Claude Code, Copilot, Cursor, Codex, OpenCode, Gemini CLI, Windsurf и Claude Desktop.

Проверка

На учебной базе спросите: «Какая у нас политика повторных попыток для вызовов эквайера?» — в журнале запросов появятся search_context и compile_bundle.

Примеры задач

Собери контекст для задачи PAY-123 с бюджетом 2000 токенов.
Найди в базе знаний битые ссылки и предложи исправления через propose_update.

Риски

  • Pull request от агента. propose_update создаёт ветки и при настроенном токене форжа открывает pull request; индекс не меняется до слияния.
  • Токен сервера. Без api_token сервер работает без авторизации — только в доверенной сети.
  • Журнал запросов хранится 30 дней по умолчанию для отчёта о пробелах; его можно выключить.

Частые вопросы

Нужна ли векторная база?

Нет, хватает одного файла SQLite и встроенных эмбеддингов.

Поддерживается ли русский?

Модель по умолчанию многоязычная и охватывает больше 100 языков.

Может ли агент сам менять знания?

Только через ветку или pull request, которые сливает человек.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники