Ref Tools MCP

Ref Tools MCP

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

Подключить Ref Tools MCP

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

1

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

2

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

3

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

Claude Desktop / Claude Code

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

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

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

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

Как оценить Ref Tools MCP

Ref Tools MCP относится к Разработка, Поиск. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

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

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

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

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

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

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

Общее

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

Поделиться