ref-tools-mcp

ref-tools-mcp

ref-toolsMIT
1.1k звёзд66 форков
ref-tools-mcp — сервер для поиска документации, который экономит токены и контекст вашего ИИ-агента. Вместо того чтобы загружать весь сайт документации, он находит и возвращает только те фрагменты текста, которые нужны агенту для ответа на вопрос. Это решает проблему «контекстной гнили» — когда контекст забивается бесполезной информацией, и модель начинает ошибаться. Сервер работает как прокси-поисковик. Он принимает текстовый запрос, ищет по публичной и приватной документации API, библиотек и сервисов, а затем отдаёт чистый текст. Разработчики подключают его к Claude Code, Cline или любому другому MCP-клиенту, чтобы дать ассистенту доступ к актуальной базе знаний. Сервер написан на TypeScript, распространяется под лицензией MIT и не требует регистрации или API-ключей.
DevelopmentSearch
Открыть на GitHub

Установка

npx -y ref-tools-mcp

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

Общее

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

Технологии

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

Описание

Возможности

  • Поиск документации по ключевым словам: отправляете запрос — получаете список релевантных страниц с заголовками и URL.
  • Чтение содержимого страниц: агент может открыть конкретную страницу и получить её текст в чистом виде, без вёрстки и рекламы.
  • Автоматическая дедупликация: в рамках одной сессии сервер не возвращает уже прочитанные страницы. Это заставляет агента уточнять запрос и копать глубже.
  • Итеративный поиск: агент может последовательно менять поисковый запрос, читать промежуточные результаты и находить именно то, что нужно — как живой разработчик.
  • Работа со сложными многосоставными запросами: сервер справляется с вопросами, которые требуют сбора контекста из нескольких статей (например, «как объединить данные из двух источников в n8n»).
  • Прозрачность потребления токенов: каждый вызов возвращает количество потраченных токенов. Вы точно знаете, сколько контекста ушло на поиск и чтение.
  • Поддержка любых сайтов документации: сервер работает с HTML-страницами, парсит их и извлекает основной контент. Не требует специальной интеграции для каждого сайта.

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

Убедитесь, что на вашей машине установлен Node.js версии 18 или выше. Сервер устанавливается и запускается одной командой через npx. Для работы не требуется глобальная установка или дополнительные файлы.

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

{ "mcpServers": { "ref-tools-mcp": { "command": "npx", "args": ["-y", "ref-tools-mcp"] } } }

Перезапустите клиент. В списке доступных инструментов появятся search и read. После этого ассистент сможет искать документацию и читать страницы.

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

Вот несколько задач, которые сможет решить ваш ИИ-ассистент после подключения сервера:

  • «Найди в документации Stripe API эндпоинт для создания подписки и покажи пример запроса на cURL с idempotency key.»
  • «Прочитай статью о хуке useEffect на сайте React. Объясни, чем он отличается от useLayoutEffect, и приведи пример с очисткой таймера.»
  • «Найди в документации n8n раздел про Merge-ноду. Как объединить данные из двух источников: один из вебхука, другой из триггера по расписанию?»
  • «Проверь в документации Prisma, как писать запросы с вложенными соединениями (nested includes) для реляционных данных. Покажи пример для users и posts.»

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

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Клиенты: любые MCP-совместимые (Claude Desktop, Claude Code, Cline)

Поделиться