Gnosis MCP

Gnosis MCP

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

Подключить Gnosis MCP

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "gnosis": {
      "command": "uvx",
      "args": [
        "gnosis-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Gnosis MCP

Gnosis MCP относится к Базы данных, PostgreSQL. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

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

Общее

  • СтатусСообщество
  • Разработчик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)

Поделиться