MCP 服务器

web-search-for-agents

MCP server that gives AI agents access to current web information through web_search and fetch_url tools, using Tavily, Brave, and DuckDuckGo providers with automatic fallback.

README

🔍 Web Search for Agents (MCP)

Даёт AI-агентам внутри VS Code доступ к актуальной информации из интернета через стандартный протокол MCP (Model Context Protocol).

✨ Зачем это нужно

AI-агенты (GitHub Copilot Agent, Qoder CN, Cline, Roo Code и др.) имеют ограниченный контекст и «устаревшие» знания. Это расширение добавляет им два инструмента:

web_search — поиск актуальной информации в интернете
fetch_url — получение очищенного текста любой веб-страницы

Агент сам решает, когда и какой инструмент использовать — вы просто задаёте вопрос, а он ищет свежие данные.

🤝 Поддерживаемые агенты

Агент	Как подключить
GitHub Copilot (Agent mode)	Автоматически через VS Code MCP API
Qoder CN (бывший Tongyi Lingma)	Кнопкой `Install to Qoder CN`
Cline	Кнопкой `Install to Cline`
Roo Code / Continue / Cursor	Вставкой JSON-конфига из буфера обмена

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

1. Установка

Установите расширение из Marketplace или через .vsix:

code --install-extension web-search-for-agents-0.1.0.vsix

2. Откройте панель настроек

Кликните по иконке 🔍 Web Search в нижней панели VS Code
или выполните команду:

3. Получите API-ключи (рекомендуется)

Провайдер	Приоритет	Бесплатный лимит	Где получить
Tavily	1 (лучшее качество)	1000 запросов/мес	tavily.com
Brave Search	2	2000 запросов/мес	brave.com/search/api
DuckDuckGo	3 (fallback)	∞ без ключа	ключ не нужен

Вставьте ключи в Webview и нажмите Сохранить.

4. Установите в вашего агента

Для Qoder CN → нажмите кнопку Install to Qoder CN
Для Cline → нажмите кнопку Install to Cline
Для других агентов → нажмите Copy MCP Config и вставьте JSON в настройки агента

5. Работайте!

В режиме Agent спросите у ИИ что-то требующее свежих данных:

«Какая сейчас последняя стабильная версия Node.js?» «Найди актуальные курсы рубля к доллару на сегодня» «Прочитай содержимое https://example.com и сделай краткий пересказ»

🔧 Как это работает

Каскад провайдеров поиска

При вызове web_search расширение пытается провайдеры строго по порядку:

Если провайдер недоступен или вернул ошибку — автоматический переход к следующему. Это гарантирует, что поиск всегда работает, даже без ключей.

Инструменты MCP

Инструмент	Параметры	Описание
`web_search`	`query` (обязательный), `num_results` (1–10, по умолч. 6)	Поиск в интернете, возврат заголовка, URL и сниппета
`fetch_url`	`url` (обязательный)	Загрузка страницы и возврат очищенного основного текста (скрипты/стили убраны, ~20 000 символов)

Безопасность

🔐 API-ключи хранятся в VS Code Secret Storage (не в settings.json)
🔐 Ключи передаются в MCP-сервер через переменные окружения (не попадают в конфиг)
🔐 fetch_url принимает только http:// и https:// (защита от file://, ftp:// и т.п.)

🎛️ Команды расширения

Все команды доступны через Ctrl+Shift+P:

Web Search: Open Settings Panel — открыть Webview с настройками
Web Search: Set Tavily API Key — ввести/обновить ключ Tavily
Web Search: Set Brave API Key — ввести/обновить ключ Brave
Web Search: Clear API Keys — удалить все ключи
Web Search: Install to Qoder CN — прописать сервер в mcp.json Qoder CN
Web Search: Install to Cline — прописать сервер в конфиг Cline
Web Search: Copy MCP Config — скопировать JSON-конфиг в буфер обмена

📦 Ручная установка MCP-сервера

Если ваш агент не поддерживается кнопками установки, вставьте в его mcp.json (путь зависит от агента):

{
  "mcpServers": {
    "web-search-for-agents": {
      "command": "node",
      "args": [
        "C:\\путь\\к\\расширению\\dist\\server.js"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-...",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

Важно: требуется Node.js ≥ 18. Путь к server.js должен быть абсолютным.

🛠️ Для разработчиков### Тестирование сервера без VS Code

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/server.js

Сборка VSIX для публикации

npm run package

🗺️ Roadmap

[ ] Поддержка провайдера Exa.ai
[ ] Поддержка провайдера Firecrawl (улучшенный fetch_url)
[ ] Кэширование результатов поиска
[ ] История последних запросов в Webview
[ ] Настройка лимита размера страницы в fetch_url
[ ] Индикатор прогресса при поиске

❓ Troubleshooting

Агент не видит инструменты

Проверьте, что Node.js установлен (node --version должно выдавать ≥ 18)
Перезапустите VS Code после установки расширения
В Qoder CN: Settings → MCP Server — проверьте, что web-search-for-agents активен
В Cline: откройте cline_mcp_settings.json и убедитесь, что путь к server.js корректный

Поиск возвращает пустой результат

DuckDuckGo иногда блокирует частые запросы — добавьте ключ Tavily или Brave
Проверьте подключение к интернету
Посмотрите вывод в консоли агента — там могут быть ошибки

Ключи не сохраняются

Secret Storage VS Code должен быть доступен (обычно так и есть)
Попробуйте удалить и ввести ключ заново через Webview

📄 Лицензия

<p align="center"> Сделано с ❤️ для AI-агентов и разработчиков </p>

Сборка из исходников

git clone https://github.com/your-user/web-search-for-agents
cd web-search-for-agents
npm install
npm run build

Запуск в режиме разработки

Откройте проект в VS Code
Нажмите F5 — запустится Extension Development Host
Тестируйте команды и Webview

Структура проекта

web-search-for-agents/ ├── src/ │ ├── extension.ts # Точка входа расширения │ ├── mcp/ │ │ ├── server.ts # stdio MCP-сервер │ │ ├── tools/ # web_search, fetch_url │ │ └── providers/ # tavily, brave, duckduckgo + cascade │ ├── commands/ # Команды и установщики │ ├── ui/ # Webview + Status Bar │ └── utils/ # Secret Storage, генерация конфигов ├── dist/ # Собранные бандлы (создаётся при build) ├── build.mjs # Сборщик (esbuild) └── package.json