MCP WebSearch

MCP-сервер для Claude Code: веб-поиск через Perplexity Sonar и генерация изображений — всё одним ключом OpenRouter.

Написан под одну задачу: не давать агенту случайно потратить лишнее. Дорогая модель поиска не является дефолтом, а у генерации картинок есть отдельный тул для расчёта цены до вызова.

Установка

git clone git@github.com:DrSeedon/mcp-websearch.git ~/.claude/mcp-servers/websearch
cd ~/.claude/mcp-servers/websearch
npm install
cp .env.example .env   # и вписать свой ключ

Регистрация в Claude Code:

claude mcp add websearch node ~/.claude/mcp-servers/websearch/index.js \
  -e OPENROUTER_API_KEY=sk-or-v1-...

Требуется Node 18+ (используется нативный fetch и ESM).

Related MCP server: sysauto Ask MCP Server

Переменные окружения

Ключ читается только из окружения — в коде его нет и быть не должно.

Тулы

search

Веб-поиск через Perplexity Sonar. Возвращает ответ, источники и стоимость запроса.

Других search-моделей нет — список закрыт на уровне кода.

Почему это важно: разница в цене пятикратная. Если сделать дорогую модель дефолтом, агент будет вызывать её не думая. Проверено на живой установке: 171 запрос из 425 ушёл по дорогому тарифу просто потому, что модель не указывали явно.

generate_image

Генерация изображений. Поддерживает референсные картинки на вход и соотношения сторон от 21:9 до 9:16.

generate_image_cost

Считает стоимость генерации до вызова. Нужен, чтобы выбор модели был осознанным, а не «взял первую из списка».

Логи

requests.log (в .gitignore) — JSONL, по строке на вызов: [iso] tool: {json}.

• search — запрос, полный ответ, источники, модель, токены, стоимость

• generate_image — промпт, пути сохранения, размер, референсы; base64 в лог не пишется

• рядом с картинкой в generated/ кладётся .json с тем же промптом и метаданными

Что не коммитится

.env, requests.log, generated/ (архив сгенерированных картинок), node_modules/. Логи и картинки содержат историю запросов — это приватные данные, им не место в репозитории.