MCP WebSearch

MCP-Server für Claude Code: Websuche über Perplexity Sonar und Bildgenerierung – alles mit einem einzigen OpenRouter-Schlüssel.

Geschrieben für eine einzige Aufgabe: dem Agenten nicht erlauben, unnötig Geld auszugeben. Die teure Suchmodell ist nicht der Standard, und für die Bildgenerierung gibt es ein separates Tool zur Kostenberechnung vor dem Aufruf.

Installation

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

Registrierung in Claude Code:

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

Erfordert Node 18+ (verwendet natives fetch und ESM).

Related MCP server: sysauto Ask MCP Server

Umgebungsvariablen

Der Schlüssel wird nur aus der Umgebung gelesen – im Code ist er nicht vorhanden und darf es auch nicht sein.

Tools

search

Websuche über Perplexity Sonar. Gibt Antwort, Quellen und Kosten der Anfrage zurück.

Andere Suchmodelle gibt es nicht – die Liste ist auf Code-Ebene geschlossen.

Warum das wichtig ist: Der Preisunterschied ist fünffach. Wenn man das teure Modell zum Standard machen würde, würde der Agent es ohne nachzudenken aufrufen. In der Praxis getestet: 171 von 425 Anfragen liefen über den teuren Tarif, nur weil das Modell nicht explizit angegeben wurde.

generate_image

Bildgenerierung. Unterstützt Referenzbilder als Eingabe und Seitenverhältnisse von 21:9 bis 9:16.

generate_image_cost

Berechnet die Kosten der Generierung vor dem Aufruf. Notwendig, damit die Modellwahl bewusst erfolgt und nicht einfach „das erste aus der Liste“ genommen wird.

Logs

requests.log (in .gitignore) – JSONL, eine Zeile pro Aufruf: [iso] tool: {json}.

• search – Anfrage, vollständige Antwort, Quellen, Modell, Tokens, Kosten

• generate_image – Prompt, Speicherpfade, Größe, Referenzen; base64 wird nicht ins Log geschrieben

• neben dem Bild in generated/ liegt eine .json-Datei mit demselben Prompt und Metadaten

Was nicht eingecheckt wird

.env, requests.log, generated/ (Archiv generierter Bilder). Logs und Bilder enthalten den Verlauf der Anfragen – das sind private Daten, die im Repository nichts zu suchen haben.