Gnosis MCP

Gnosis MCP

nicholasglazerMIT
23 звёзд8 форков
Gnosis MCP — сервер для AI-ассистентов, который ищет нужную информацию в вашей локальной документации. Вместо того чтобы копировать целые файлы в контекст, вы отправляете запрос — и получаете точные цитаты из ваших документов. Это снижает расход токенов в 5–10 раз на один поисковый запрос. Сервер подходит разработчикам, которые активно используют AI-кодинг и хотят, чтобы ассистент отвечал на основе актуальной документации проекта. Gnosis MCP работает полностью локально: данные хранятся в SQLite или PostgreSQL, никакие запросы не уходят в облако. По тестам, точность поиска (Hit@5) составляет 92% на реальных разработческих документах. Встроенный механизм чанкования разбивает документы на фрагменты, ранжирует их по релевантности и возвращает только то, что нужно — без лишних токенов.
DatabasesPostgres
Открыть на GitHub

Установка

uvx gnosis-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикnicholasglazer
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Поиск по документации с ранжированием и подсветкой результатов (инструмент search_docs)
  • Индексация локальных Markdown-файлов из указанных директорий
  • Захват git-коммитов как документов: индексируются сообщения коммитов и изменения
  • Краулинг веб-страниц документации с сохранением структуры и контента
  • Хранение индекса в SQLite (по умолчанию) или PostgreSQL для больших объёмов
  • Генерация эмбеддингов через sentence-transformers: поддерживаются модели all-MiniLM-L6-v2, BAAI/bge-small-en-v1.5 и другие
  • Настройка размера чанка документа для баланса скорости и качества поиска
  • Просмотр статистики индекса: количество документов, размер, дата последнего обновления
  • Встроенный инструмент оценки качества gnosis-mcp eval с бенчмарком BEIR SciFact
  • Режим serve для публикации документации как MCP-сервера для удалённых агентов
  • Совместимость с любыми MCP-клиентами: Claude Desktop, VS Code, JetBrains, Continue.dev, Cursor, Zed
  • Установка через uvx без необходимости вручную настраивать зависимости

Как подключить

Установите Gnosis MCP одной командой через uvx: uvx gnosis-mcp.

Если uvx не установлен, используйте pip: pip install gnosis-mcp.

Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop (файл claude_desktop_config.json):

{"mcpServers": {"gnosis": {"command": "uvx", "args": ["gnosis-mcp"]}}}

Если вы используете PostgreSQL, добавьте DSN в аргументы:

{"mcpServers": {"gnosis": {"command": "uvx", "args": ["gnosis-mcp", "--dsn", "postgresql://user:pass@localhost/db"]}}}

Перезапустите клиент. Теперь AI-ассистент сможет выполнять команду search_docs для поиска по вашей документации.

Примеры запросов

  • «Найди описание функции authenticate и покажи пример её использования в документации»
  • «Покажи последние 5 коммитов, которые связаны с настройкой базы данных»
  • «Проиндексируй папку ./docs и найди все упоминания аутентификации через JWT»
  • «Найди в документации раздел про конфигурацию PostgreSQL и выведи основные параметры»

Технические детали

  • Язык: Python
  • Транспорт: stdio (MCP-протокол)
  • Лицензия: MIT
  • Поддерживаемые бэкенды: SQLite (по умолчанию), PostgreSQL
  • Модели эмбеддингов: all-MiniLM-L6-v2, BAAI/bge-small-en-v1.5 и другие (через sentence-transformers)
  • Совместимые клиенты: любые MCP-клиенты, включая Claude Desktop, VS Code (Continue.dev), JetBrains, Cursor, Zed
  • Минимальная версия Python: 3.10
  • Установка: uvx gnosis-mcp или pip install gnosis-mcp
  • Оценка качества: встроенный eval с датасетом BEIR SciFact (0.671 nDCG@10)

Поделиться