Kindly Web Search MCP Server

Установка

Работает в

• Claude Code
• Codex
• Gemini CLI
• Cursor
• Windsurf
• SourceCraft
• Koda
• Coddy

Ручная установка

claude mcp add --transport stdio kindly-web-search \
  -e SERPER_API_KEY="$SERPER_API_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e KINDLY_BROWSER_EXECUTABLE_PATH="$KINDLY_BROWSER_EXECUTABLE_PATH" \
  -- uvx --from git+https://github.com/Shelpuk-AI-Technology-Consulting/kindly-web-search-mcp-server \
  kindly-web-search-mcp-server start-mcp-server

Что делает

Kindly Web Search ищет в сети и в том же ответе возвращает содержимое найденных страниц в формате Markdown. Инструмент web_search принимает запрос и число результатов, по умолчанию три, и возвращает заголовок, ссылку, сниппет и page_content. Инструмент get_content достает текст по готовой ссылке. Агенту не нужен второй вызов скрейпера: вопрос, ответы и комментарии приходят вместе. Каждую ссылку сервер пропускает через цепочку специализированных обработчиков. Для Stack Exchange он вызывает API сайта, для GitHub Issues и Discussions использует GraphQL, для Wikipedia обращается к MediaWiki, а статьи arXiv берет через Atom API и превращает PDF в Markdown. Все остальные страницы открывает в браузере без окна на базе Chromium через пакет `nodriver`. У сайтов с документацией в Markdown есть быстрый путь: сервер сначала пробует скачать готовый Markdown обычным запросом, а браузер запускает только при неудаче. Поисковых провайдеров много: Serper, SerpBase, Tavily, SearXNG, Sofya, You.com, Serply и Apifare. Сервер берет первого, чей ключ задан, в этом порядке.

Для кого. Для разработчиков, которые отлаживают ошибки в Claude Code, Codex или Cursor и хотят, чтобы агент получал целые обсуждения вместе с поисковой выдачей.

Пример запроса к агенту

Найди, почему задача Google Cloud Batch с GPU падает через полчаса, и прочитай найденные обсуждения целиком

MCP

Транспорт

stdio

Авторизация

API-ключ

Ограничения

Нужен ключ одного из поисковых провайдеров или адрес SearXNG, а для произвольных сайтов еще и браузер на базе Chromium на той же машине, где запущен MCP-клиент: Chrome, Chromium, Edge или Brave. Путь к браузеру можно задать переменной KINDLY_BROWSER_EXECUTABLE_PATH.

GITHUB_TOKEN необязателен, но с ним Issues приходят в виде, подготовленном для модели, и реже упираются в лимиты API. Токена с правом только на чтение публичных репозиториев достаточно.

Поддерживаются Python 3.13 и 3.14. На 3.14 расширенная разметка PDF отключена, потому что готовые сборки пакета `onnxruntime` могут быть недоступны. Доступность поисковых провайдеров из России при подготовке карточки не проверялась.

Как отключить. Выполните `claude mcp remove kindly-web-search` в Claude Code или `codex mcp remove kindly-web-search` в Codex. Если сервер прописан в файле, удалите запись kindly-web-search из .mcp.json, ~/.codex/config.toml или ~/.gemini/settings.json. Ключи поисковых провайдеров отзовите в их кабинетах.

Коротко о README

Проект входит в набор Shelpuk AI Technology Consulting из трех MCP-серверов (Serena, Kindly Web Search, Lad MCP Server) и скилла `tdd`. Для Codex, Claude Code, Gemini CLI, OpenClaw и Antigravity даны отдельные способы подключения, в том числе для PowerShell. Дополнительные переменные настраивают получение готового Markdown с сайтов документации и вывод GitHub Issues.