Repolode
ref-tools

ref-tools/ref-tools-mcp

MCP-сервер, который помогает AI-агентам для программирования экономно расходовать токены при работе с документацией публичных и приватных библиотек.

Звёзды
1,184
Форки
72
Открытые issues
12
Последний коммит
вчера

Что это?

Ref MCP — это сервер Model Context Protocol, с помощью которого AI-инструменты и агенты для программирования могут искать и читать документацию по API, сервисам и библиотекам. Он предоставляет инструмент поиска: тот принимает запрос в виде полного предложения и возвращает подходящие результаты с публичных веб-страниц, GitHub и из приватных источников, например репозиториев и PDF-файлов. Также есть инструмент чтения: он загружает страницу по URL и преобразует её в Markdown.

Проект помогает экономить место в контекстном окне агента. В рамках одной MCP-сессии сервер запоминает предыдущие запросы, чтобы не возвращать одни и те же результаты повторно. При чтении длинной страницы он отбрасывает менее релевантные разделы с учётом истории поиска и возвращает примерно 5k самых релевантных токенов вместо всей страницы.

Сервер можно подключить через размещённую точку доступа streamable-http — проект рекомендует этот вариант — или запустить локально через stdio с помощью npx. Также предусмотрены имена инструментов, совместимые с клиентами OpenAI deep research.

Ключевые возможности

  • 01Ищет информацию в публичном вебе, GitHub и приватной документации с помощью одного инструмента.
  • 02Не возвращает результаты, которые уже показывал в этой сессии, чтобы избежать повторов.
  • 03Преобразует страницу по URL в Markdown и оставляет только самые релевантные разделы.
  • 04Поддерживает подключение через streamable-http и локальный запуск через stdio.
  • 05Предоставляет имена инструментов, совместимые с OpenAI deep research.

Сценарии использования

  • Помогает агенту для программирования находить актуальные API-эндпоинты при написании интеграционного кода.
  • Даёт агенту доступ к внутренней документации приватных библиотек и репозиториям.
  • Сокращает расход токенов и объём лишней информации при чтении агентами длинных страниц документации.

Быстрый старт

  1. 1

    Зарегистрируйтесь на ref.tools, чтобы получить API-ключ

  2. 2

    Добавьте stdio-сервер в конфигурацию MCP-клиента и запустите его с помощью npx, указав REF_API_KEY

    npx ref-tools-mcp@latest

Что важно знать

  • Требуется API-ключ Ref, который можно получить после регистрации на ref.tools.
  • В этом репозитории содержится устаревший stdio-сервер; в README вместо него рекомендуется использовать размещённый streamable-http-сервер.

В подборках

Темы

Частые вопросы

Что такое ref-tools-mcp?
MCP-сервер, который помогает AI-агентам для программирования экономно расходовать токены при работе с документацией публичных и приватных библиотек. Ref MCP — это сервер Model Context Protocol, с помощью которого AI-инструменты и агенты для программирования могут искать и читать документацию по API, сервисам и библиотекам. Он предоставляет инструмент поиска: тот принимает запрос в виде полного предложения и возвращает подходящие результаты с публичных веб-страниц, GitHub и из приватных источников, например репозиториев и PDF-файлов. Также есть инструмент чтения: он загружает страницу по URL и преобразует её в Markdown.
ref-tools-mcp можно использовать бесплатно? Какая у него лицензия?
ref-tools-mcp распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ref-tools-mcp всё ещё поддерживается?
Активно поддерживается. Последний коммит в ref-tools-mcp — 6 нояб. 2026 г..
Для чего можно использовать ref-tools-mcp?
Помогает агенту для программирования находить актуальные API-эндпоинты при написании интеграционного кода. Даёт агенту доступ к внутренней документации приватных библиотек и репозиториям. Сокращает расход токенов и объём лишней информации при чтении агентами длинных страниц документации.
Как установить ref-tools-mcp?
Зарегистрируйтесь на ref.tools, чтобы получить API-ключ Добавьте stdio-сервер в конфигурацию MCP-клиента и запустите его с помощью npx, указав REF_API_KEY: npx ref-tools-mcp@latest
Где скачать ref-tools-mcp?
Исходный код и инструкции по установке — на GitHub: https://github.com/ref-tools/ref-tools-mcp

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты