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.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.