compendio-mcp — MCP-сервер для Claude Code: обзор и установка
Индексирует Markdown-файлы проекта и даёт агенту точные фрагменты через локальный гибридный поиск. Помогает отвечать по документации без выгрузки целых файлов в контекст.
claude mcp add compendio-mcp -- npx -y compendio-mcpЧто делает compendio-mcp
Сервер находит нужные данные в документации проекта вместо чтения файлов целиком через grep или cat. Для этого используется гибридный поиск: точные термины находятся по ключевым словам, а смысл формулировок раскрывается через локальные векторные эмбеддинги. Результаты объединяются, возвращая только необходимый фрагмент текста.
Индекс сохраняется локально в SQLite по пути .compendio/compendio.db. Для расчёта векторов используется модель Xenova/multilingual-e5-small на процессоре, поэтому внешние API-ключи и фоновые демоны не нужны. Сервер сам отслеживает правки в файлах .md и обновляет базу по мере работы.
Для запуска требуется Node.js версии не ниже 22.12. При первом старте индекс скачивает модель весов объёмом в десятки мегабайт, поэтому команду compendio index надёжнее запустить вручную в терминале до передачи задачи агенту.
Какие задачи решает
- экономить токены контекста при поиске ответов в базе знаний
- находить разделы в Markdown по смыслу вопроса, а не только по ключевым словам
- избегать чтения многостраничных документов целиком через
cat - поддерживать поисковый индекс документации в актуальном виде без отдельного демона
Примеры запросов агенту
- Найди в документации проекта требования к авторизации и покажи нужный раздел
- Поищи в
.mdфайлах архитектурные решения по синхронизации данных
Как установить compendio-mcp
Командой платформы
claude mcp add compendio-mcp -- npx -y compendio-mcpКомандой платформы
codex mcp add compendio-mcp -- npx -y compendio-mcpФайл настроек
{
"mcpServers": {
"compendio-mcp": {
"command": "npx",
"args": [
"-y",
"compendio-mcp"
]
}
}
}Файл настроек
{
"servers": {
"compendio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"compendio-mcp"
]
}
}
}Командой платформы
gemini mcp add compendio-mcp npx -y compendio-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о compendio-mcp
Как установить compendio-mcp в Claude Code?
Выполните команду claude mcp add compendio-mcp -- npx -y compendio-mcp. Перед этим убедитесь, что в системе установлен Node.js версии не ниже 22.12.
Что делает compendio-mcp?
Сервер строит индекс по Markdown-документам репозитория и передаёт ассистенту релевантные цитаты через гибридный поиск. Это исключает рутинное чтение сотен строк исходных файлов.
Нужен ли внешний API-ключ для работы поиска?
Внешние сервисы не используются. Вся база данных SQLite хранится локально, а модель эмбеддингов Xenova/multilingual-e5-small работает непосредственно на CPU вашей машины.
