网络搜索增强服务

网络搜索增强服务是 L-1ngg 开发的 MCP 服务器：Grok Search MCP 是一个基于 FastMCP 构建的 MCP 服务器，采用双引擎架构（Grok AI 搜索。接入两步走：见官方 README，再把下文配置粘进客户端 mcpServers 段重启即可。

先把话说清楚：网络搜索增强服务不是又一个大模型，而是一个标准的 MCP 服务器。装好之后，你的 AI 客户端多出一组新工具，模型可以按需调用。Grok Search MCP 是一个基于 FastMCP 构建的 MCP 服务器，采用双引擎架构（Grok AI 搜索 + Tavily 网页抓取/站点映射），为 Claude

• 多 Tavily Key 支持：支持通过 TAVILYAPIKEYS 配置多个 Tavily API Key，并在单个 Key 失败后按冷却时间自动轮换。
• Tavily 调用统一封装：将 Tavily 的 search、extract、map 调用统一收敛到客户端中，复用同一套 Key 选择、失败冷却与错误处理逻辑。
• 多 Key 场景兼容修正：额外信源补充、网页抓取与站点映射等 Tavily 相关能力，改为基于多 Key 配置判断可用性，使 TAVILYAPIKEYS 场景下能够正常工作。

两类人最该装：一是做信息聚合、需要给 AI 一个可调用搜索入口的开发者；二是已经在用 MCP 生态、想按需拼装能力的折腾型用户。反过来，如果你只需要偶尔手动用它背后的服务，直接开网页就行，不必上 MCP。

动手前确认环境齐了：

• 一个支持 MCP 的客户端：Claude Desktop、Cursor、Cline、Windsurf 任选其一。
• 对应平台的 API Key（第 2 步要用）。

安装命令随版本更新较频繁，以 官方 README 顶部 Installation 一节为准。

先把凭证准备好：GROK_API_KEY、TAVILY_API_KEYS、TAVILY_API_KEY、FIRECRAWL_API_KEY。拿不到后面全白搭。

Claude Desktop 的配置文件路径：macOS 在 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 在 %APPDATA%\Claude\claude_desktop_config.json；Cursor 则是 ~/.cursor/mcp.json（或项目级 .cursor/mcp.json）。把下面这段并进 mcpServers 段（注意是并进外层大括号，别整个文件替换）：

将以下命令中的环境变量替换为你自己的值后执行。Grok 接口需为 OpenAI 兼容格式；Tavily 为可选配置，未配置时工具 `web_fetch` 和 `web_map` 不可用。

<details> <summary>如果遇到 SSL / 证书验证错误</summary>

在部分企业网络或代理环境中，可能会出现类似错误：

certificate verify failed
self signed certificate in certificate chain

可以在 uvx 参数中添加 --native-tls，使其使用系统证书库：

claude mcp add-json web-search --scope user '{
  "type": "stdio",
  "command": "uvx",
  "args": [
    "--native-tls",
    "--from",
    "git+https://github.com/GuDaStudio/GrokSearch@grok-with-tavily",
    "web-search"
  ],
  "env": {
    "GROK_API_URL": "https://your-api-endpoint.com/v1",
    "GROK_API_KEY": "your-grok-api-key",
    "TAVILY_API_KEYS": ["tvly-your-tavily-key1", "tvly-your-tavily-key2"],
    "TAVILY_API_URL": "https://api.tavily.com"
  }
}'

</details>

改完保存。Windows 用户注意：如果 command 写 npx 起不来，换成 npx.cmd 再试。

完全退出客户端再打开（是托盘里真正退出，不是关窗口）。工具列表里出现网络搜索增强服务的工具即接入成功；调用报错的话，先查下面的坑点清单。

• Key 填了但没生效：多半填在了 args 而不是 env 段。客户端日志里看到 Environment variable GROK_API_KEY not set 就是这个原因。
• 改了配置没反应：客户端只重启了窗口没退进程。macOS 按 Cmd+Q，Windows 检查托盘。
• JSON 报错打不开客户端：多半是最后多个逗号。粘进任何 JSON 校验器里查一遍再保存。