Ref MCP
MCP-сервер Ref: поиск по документации API и библиотек, который отдает агенту только нужные куски страниц
- 1 185 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Отправляет поисковые запросы во внешний сервис
- Может индексировать приватные репозитории и PDF
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ref-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Отправляет поисковые запросы во внешний сервис
- Может индексировать приватные репозитории и PDF
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ref дает агенту два инструмента: поиск по технической документации и чтение страницы по адресу с конвертацией в Markdown. Искать можно по публичной документации в сети и на GitHub, а также по приватным источникам вроде репозиториев и PDF. Сервер помнит историю поиска в сессии: не возвращает уже показанные результаты и при чтении большой страницы оставляет только самые подходящие фрагменты. Это экономит контекст по сравнению с обычным fetch. Для клиентов OpenAI инструменты доступны под именами search и fetch.
Для кого. Для разработчиков, чьи агенты часто обращаются к документации сторонних API и библиотек и тратят на это много токенов.
Подходит, если
- Агент ошибается в API библиотеки, которую знает по устаревшим данным
- Обычный fetch документации забивает контекст
- Нужно искать по приватной документации команды
Не подходит, если
- Нет возможности зарегистрироваться и получить ключ Ref
- Документация уже лежит в репозитории и доступна агенту как файлы
Пример запроса к агенту
Найди в документации Figma API эндпоинт для добавления комментария и покажи параметрыMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
REF_API_KEYобязательная, секрет- Ключ API Ref для stdio-сервера
Ограничения
Нужна регистрация на ref.tools и ключ API, условия тарифов описаны на сайте. Этот репозиторий содержит устаревший stdio-сервер, авторы рекомендуют удаленный HTTP. Запросы уходят во внешний сервис, доступность из России без VPN не проверена.
Как отключить. Удалите блок Ref из конфигурации MCP клиента.
Частые вопросы
Какой вариант подключения выбрать?
Удаленный HTTP: авторы называют его рекомендуемым, а stdio-сервер из этого репозитория устаревшим.
Чем Ref отличается от обычного чтения страниц?
При чтении он оставляет около 5 тысяч токенов самых релевантных разделов с учетом прошлых поисков, а не всю страницу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыDocs MCP Server
Grounded Docs MCP Server
Локальный MCP-сервер: индексирует документацию из сайтов, GitHub, npm, PyPI и файлов и дает агенту поиск по нужной версии
Удаленный MCP-сервер, который отдает агенту документацию и код любого публичного GitHub-репозитория без установки
Deepwiki MCP
Deepwiki MCP Server
MCP-сервер, который забирает страницы deepwiki.com, чистит их и отдает агенту в Markdown: одним документом или по страницам
MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
MCP сервер структурного поиска по коду для агентов: находит нужный файл по смыслу запроса и работает локально
MCP-сервер, который отвечает агенту на вопросы по документации одного крейта Rust точной версии
Коротко о README
README объясняет, как агент ищет и читает документацию через Ref, на примерах цепочек вызовов. Описаны два механизма экономии контекста и почему лишние токены вредят качеству и стоимости. Приведены конфигурации для HTTP и stdio, описаны инструменты и совместимость с deep research OpenAI. Лицензия MIT.