Адаптер подключает Pi coding agent к MCP-серверам через один прокси-инструмент, чтобы описания неиспользуемых инструментов не занимали контекст.
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
Зарегистрируйтесь на ref.tools, чтобы получить API-ключ
- 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 обновляется ежедневно.
Похожие проекты
MCP-сервер и CLI, которые передают AI-агентам для написания кода актуальную документацию и примеры кода для конкретных версий библиотек.
Веб-браузер API-документации: объединяет справочники для разработчиков в одном интерфейсе с поиском и офлайн-доступом.
Локальный MCP-сервер, который перенаправляет запросы из Cursor, VS Code, Windsurf или Claude Desktop в ChatGPT, Claude, Gemini, Perplexity, BYOK API или локальные модели Ollama.
CLI для создания и поддержки связанной Markdown-вики по кодовой базе с опорой на исходный код — для вас и ваших coding agents.
Сжимает вывод инструментов, логи, файлы и фрагменты RAG перед отправкой в LLM — в виде библиотеки, прокси или MCP-сервера.