MCP WebSearch

用于 Claude Code 的 MCP 服务器：通过 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 进行网页搜索。返回回答、来源和请求费用。

没有其他搜索模型——列表在代码层面被锁定。

**为什么这很重要：**价格相差五倍。如果把昂贵模型设为默认，代理会不假思索地调用它。已在真实环境中验证：425 个请求中有 171 个走了昂贵方案，仅仅因为没有显式指定模型。

generate_image

图像生成。支持输入参考图片，以及从 21:9 到 9:16 的宽高比。

generate_image_cost

在调用之前计算生成费用。目的是让模型选择有意识，而不是“从列表中随便选第一个”。

日志

requests.log（在 .gitignore 中）— JSONL，每次调用一行：[iso] tool: {json}。

• search — 请求、完整回答、来源、模型、token、费用

• generate_image — 提示词、保存路径、尺寸、参考图；base64 不写入日志

• 在 generated/ 中图片旁边会放置一个 .json，包含相同的提示词和元数据

不提交的内容

.env、requests.log、generated/（生成的图片存档）、node_modules/。日志和图片包含请求历史——这些是私有数据，不应出现在仓库中。