Gnosis MCP — MCP-сервер для Claude Code: поиск по локальным докам
Индексирует документацию проекта в SQLite и отдаёт агенту готовые фрагменты вместо целых файлов. Пригодится, когда контекст забит README и заметками.
claude mcp add gnosis -- uvx gnosis-mcpЧто делает Gnosis MCP
Gnosis MCP собирает локальный индекс из markdown, текстовых файлов, .ipynb, .toml, .csv и .json, а также из истории коммитов и обойдённых по sitemap сайтов. Поиск гибридный: BM25 по ключевым словам плюс семантика на локальных ONNX-эмбеддингах, без ключа API. Настройка сводится к pip install gnosis-mcp, gnosis-mcp ingest ./docs/ и gnosis-mcp serve — база SQLite создаётся сама.
По замыслу автора каждый вызов search_docs возвращает 200–500 токенов подсвеченных выдержек вместо 3000–15000 токенов полного чтения файла. Есть режим наблюдения за файлами, удаление устаревших чанков через --prune, полный сброс через --wipe и учёт экономии командой gnosis-mcp savings. Для больших объёмов предусмотрен PostgreSQL с pgvector и tsvector.
Кросс-энкодерный реранкинг включать не спешите: в замерах автора встроенная модель MS-MARCO роняет nDCG@10 на 27 пунктов и добавляет 400× задержки, поэтому по умолчанию он выключен. Проверяйте на своём корпусе. Команда gnosis-mcp eval гоняет девять зашитых документов и десять запросов — это дымовой тест, а не оценка вашей документации; для своих данных нужен python tests/bench/bench_real_corpus.py --corpus <docs-root> --golden <golden.jsonl>.
Какие задачи решает
- найти нужный раздел документации, не вычитывая десяток файлов
- сократить расход токенов на повторные обращения к одним и тем же докам
- подтянуть историю коммитов как контекст для агента
- проиндексировать документацию сайта по sitemap
- убрать из индекса чанки удалённых файлов
Примеры запросов агенту
- Найди в локальной документации, как настроить авторизацию через OAuth
- Проиндексируй папку
./docs/и покажи статистику по корпусу - Сколько токенов сэкономили запросы к докам за последние 7 дней?
Как установить Gnosis MCP
Командой платформы
claude mcp add gnosis -- uvx gnosis-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from gnosis-mcp <команда>
Командой платформы
codex mcp add gnosis-mcp -- uvx gnosis-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from gnosis-mcp <команда>
Файл настроек
{
"mcpServers": {
"gnosis-mcp": {
"command": "uvx",
"args": [
"gnosis-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from gnosis-mcp <команда>
Файл настроек
{
"servers": {
"gnosis-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"gnosis-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from gnosis-mcp <команда>
Командой платформы
gemini mcp add gnosis-mcp uvx gnosis-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from gnosis-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Gnosis MCP
Как установить Gnosis MCP в Claude Code?
Выполните claude mcp add gnosis -- uvx gnosis-mcp. После этого сервер доступен агенту, а документацию можно загрузить командой gnosis-mcp ingest ./docs/.
Что делает Gnosis MCP?
Строит локальный поисковый индекс по вашей документации и отдаёт агенту ранжированные фрагменты с подсветкой. Данные не покидают машину.
Нужен ли ключ API или облако?
Нет. Семантический поиск работает на локальных ONNX-эмбеддингах, по умолчанию используется SQLite. PostgreSQL с pgvector подключают, когда нужен масштаб.
