Role1776/mcp-retrieval

Что это?

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

• 01Три инструмента только для чтения: веб-поиск, поиск изображений и извлечение содержимого страниц.
• 02Поиск и содержимое страниц доступны без API-ключей поисковых систем.
• 03Содержимое страниц извлекается парсером readability и возвращается в формате Markdown.
• 04Имитация TLS-отпечатка браузера и поддержка прокси с ротацией.
• 05Поддержка транспорта stdio и потокового HTTP.
• 06Статус для каждого элемента: при частичных сбоях успешные результаты всё равно возвращаются.

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

• Получение результатов веб-поиска в реальном времени для локального LLM-ассистента без оплаты поискового API.
• Передача модели текста статей с веб-страниц в виде чистого Markdown.
• Поиск документации и актуальной информации IDE-агентом во время написания кода.
• Запуск общего сервера поиска для команды через HTTP.

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

1. 1

   Соберите бинарный файл из исходного кода (требуется Go 1.25.5 или новее).

   make build
2. 2

   Запустите сервер с транспортом stdio по умолчанию.

   ./bin/mcp-retrieval

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

• !web_scrape обрабатывает только HTML, поэтому для обычного текста и URL файлов, например raw.githubusercontent.com, ничего не возвращается.
• !Релевантность результатов поиска изображений не гарантируется: среди них могут быть нерелевантные, поэтому результаты нужно проверять.
• !Страницы загружаются без выполнения JavaScript, поэтому контент, отображаемый на стороне клиента, не извлекается.
• !Резкие всплески параллельных поисковых запросов могут вызвать проверку DuckDuckGo на ботов, из-за чего запросы будут завершаться ошибкой, пока их частота не снизится. Для распределения нагрузки нужен прокси.

В подборках

Темы

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

Что такое mcp-retrieval?

Go-сервер MCP предоставляет LLM-клиентам веб-поиск, поиск изображений и извлечение страниц в Markdown без API-ключей. mcp-retrieval — сервер Model Context Protocol, написанный на Go. Он предоставляет совместимым с MCP клиентам, таким как Claude Desktop и IDE-агенты, три инструмента только для чтения: web_search для поисковых запросов, web_search_images для поиска изображений и web_scrape для извлечения основного текста статьи со страницы в формате Markdown.

mcp-retrieval можно использовать бесплатно? Какая у него лицензия?

mcp-retrieval распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

mcp-retrieval всё ещё поддерживается?

Активно поддерживается. Последний коммит в mcp-retrieval — 24 окт. 2026 г..

Для чего можно использовать mcp-retrieval?

Получение результатов веб-поиска в реальном времени для локального LLM-ассистента без оплаты поискового API. Передача модели текста статей с веб-страниц в виде чистого Markdown. Поиск документации и актуальной информации IDE-агентом во время написания кода. Запуск общего сервера поиска для команды через HTTP.

Как установить mcp-retrieval?

Соберите бинарный файл из исходного кода (требуется Go 1.25.5 или новее).: make build Запустите сервер с транспортом stdio по умолчанию.: ./bin/mcp-retrieval

Где скачать mcp-retrieval?

Исходный код и инструкции по установке — на GitHub: https://github.com/Role1776/mcp-retrieval