MCP WebSearch

Claude Code用MCPサーバー：Perplexity Sonarによるウェブ検索と画像生成を、すべて1つのOpenRouterキーで実現。

1つのタスクのために書かれています：エージェントが余計なコストをうっかり費やさないようにすること。高価な検索モデルはデフォルトではなく、画像生成には呼び出し前に価格を計算する専用ツールが用意されています。

インストール

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モデルはありません。リストはコードレベルで制限されています。

これが重要な理由： 価格差は5倍です。高価なモデルをデフォルトにすると、エージェントは考えずにそれを呼び出してしまいます。実際のセットアップで検証済み：425件中171件のリクエストが、モデルを明示的に指定しなかっただけで高価な料金で処理されました。

generate_image

画像生成。入力として参照画像と、21:9 から 9:16 までのアスペクト比をサポートしています。

generate_image_cost

生成コストを呼び出し前に計算します。モデル選びを「リストの最初のものを選ぶ」のではなく、事前に意識した選択にすることができます。

ログ

requests.log（.gitignore 内） — JSONL形式で、1行に1回の呼び出し： [iso] tool: {json}.

• search — リクエスト、完全な回答、出典、モデル、トークン、コスト

• generate_image — プロンプト、保存パス、サイズ、参照画像；base64ファイルはログに書き込まれません

• 画像の横の generated/ には、同じプロンプトとメタデータを持つ .json が置かれます

コミットされないもの

.env, requests.log, generated/（生成画像のアーカイブ）、node_modules/。ログや画像にはリクエスト履歴が含まれます。これはプライベートデータであり、リポジトリに置くべきものではありません。