briefd — MCP-сервер для Claude Code: контекст команды по токен-бюджету
Собирает знания команды из git-репозитория в компактные контекстные наборы и отдаёт их кодинг-агенту через MCP. Пригодится, когда CLAUDE.md разросся и съедает токены на каждом ходу.
Открыть на GitHubЧто делает briefd
briefd — это компилятор контекста, который вы запускаете у себя. Знания лежат в Markdown внутри git-репозитория: терминология, бизнес-правила, архитектурные решения, договорённости. briefd индексирует их и отвечает на один вопрос агента — что нужно знать для текущей задачи — собранным и очищенным от дублей набором, который не выходит за заданный лимит токенов.
Внутри — гибридный поиск: полнотекстовый SQLite FTS5 по BM25 плюс многоязычные эмбеддинги, посчитанные кодировщиком на чистом Go, результаты объединяются через reciprocal rank fusion. Внешние сервисы не нужны: ни Postgres, ни векторной базы, ни ONNX-рантайма, ни CGO. Индекс — одноразовый кэш, который пересобирается из клона; агенты в него не пишут, а propose_update открывает ветку или pull request на ревью, и выдача меняется только после того, как человек влил изменения.
Попробовать можно без своего репозитория: briefd demo поднимает встроенную базу знаний на http://127.0.0.1:7788. Первый запуск скачивает модель эмбеддингов примерно на 470 МБ, поэтому без сети или на медленном канале он зависнет надолго; briefd demo --embeddings none пропускает загрузку. Для сборки из исходников нужен Go версии 1.26 или новее.
Какие задачи решает
- собрать контекст под задачу, не выкладывая весь
CLAUDE.mdв промпт - держать знания команды в git и ревьюить их как код
- найти нужный раздел документации по смыслу, а не по имени файла
- уложить выдачу в лимит токенов и не обрезать её вслепую
- предложить правку в базу знаний через ветку или pull request
Примеры запросов агенту
- Собери контекст под задачу: добавляю эндпоинт оплаты в сервисе заказов
- Что из наших правил и терминов нужно знать, чтобы переписать модуль авторизации?
- Предложи обновление раздела про ретраи — открывай ветку на ревью
Как установить briefd
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о briefd
Как установить briefd в Claude Code?
Сначала запустите сервер: briefd demo поднимет встроенную базу знаний на http://127.0.0.1:7788. Затем подключите его к агенту командой claude mcp add --transport http briefd http://127.0.0.1:7788/mcp.
Что делает briefd?
Индексирует Markdown-знания команды из git-репозитория и по запросу агента отдаёт собранный контекстный набор в пределах заданного лимита токенов. Поиск гибридный: BM25 по SQLite FTS5 плюс многоязычные эмбеддинги.
Чем briefd отличается от инструментов памяти агента?
Память записывает то, что агент увидел в своих сессиях, автоматически и для одного пользователя. briefd отдаёт то, что решила команда: текст пишут люди, каждое изменение проходит ревью, а устаревшие разделы видно на дашборде.
