MCP WebSearch

Servidor MCP para Claude Code: búsqueda web a través de Perplexity Sonar y generación de imágenes, todo con una sola clave de OpenRouter.

Está escrito para una sola tarea: no dejar que el agente gaste de más por accidente. El modelo de búsqueda caro no es el predeterminado, y para la generación de imágenes hay una herramienta separada para calcular el precio antes de la llamada.

Instalación

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

Registro en Claude Code:

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

Se requiere Node 18+ (se usan fetch nativo y ESM).

Related MCP server: sysauto Ask MCP Server

Variables de entorno

La clave se lee solo del entorno: en el código no está ni debe estar.

Herramientas

search

Búsqueda web a través de Perplexity Sonar. Devuelve la respuesta, las fuentes y el coste de la solicitud.

No hay otros modelos de búsqueda: la lista está cerrada a nivel de código.

Por qué es importante: la diferencia de precio es cinco veces mayor. Si el modelo caro es el predeterminado, el agente lo llamará sin pensarlo. Probado en una instalación real: 171 de 425 solicitudes se fueron por la tarifa cara solo porque el modelo no se especificaba explícitamente.

generate_image

Generación de imágenes. Admite imágenes de referencia de entrada y relaciones de aspecto de 21:9 a 9:16.

generate_image_cost

Calcula el coste de la generación antes de la llamada. Es necesario para que la elección del modelo sea consciente y no «coger el primero de la lista».

Registros

requests.log (en .gitignore) — JSONL, una línea por llamada: [iso] tool: {json}.

• search — consulta, respuesta completa, fuentes, modelo, tokens, coste

• generate_image — prompt, rutas de guardado, tamaño, referencias; el base64 no se escribe en el registro

• junto a la imagen en generated/ se coloca un .json con el mismo prompt y metadatos

Lo que no se sube

.env, requests.log, generated/ (archivo de imágenes generadas), node_modules/. Los registros y las imágenes contienen el historial de solicitudes: son datos privados y no tienen cabida en el repositorio.