适合谁
- 需要实时搜索能力的 Claude Code 用户
- 希望减少 LLM 幻觉、获取最新信息的开发者
- 需要网页抓取和站点映射功能的研究人员
G
48FMRS · D
该项目提供双引擎搜索（Grok + Tavily），功能丰富，安装简便，适合 Claude Code 用户。优势在于智能搜索和自动降级机制，但依赖外部 API 且需配置密钥。
Grok Search MCP 是一个基于 FastMCP 构建的 MCP 服务器，采用双引擎架构：Grok 负责 AI 驱动的智能搜索，Tavily 负责高保真网页抓取与站点映射，各取所长为 Claude Code / Cherry Studio 等 LLM 客户端提供完整的实时网络访问能力。
工具能力
web_search
通过 Grok API 执行 AI 驱动的网络搜索，自动检测时间相关查询并注入本地时间上下文。
get_sources
通过 session_id 获取对应 web_search 的全部信源。
web_fetch
通过 Tavily Extract API 获取完整网页内容，返回 Markdown 格式，失败时自动降级到 Firecrawl。
web_map
通过 Tavily Map API 遍历网站结构，发现 URL 并生成站点地图。
get_config_info
显示所有配置状态、测试 Grok API 连接、返回响应时间和可用模型列表。
switch_model
切换 Grok 模型，配置持久化到 ~/.config/grok-search/config.json。
toggle_builtin_tools
一键禁用或启用 Claude Code 官方的 WebSearch 和 WebFetch 工具。
search_planning
提供结构化搜索规划脚手架，用于在执行复杂搜索前生成可执行的搜索计划。
安装接入
- 安装 Python 3.10+ 和 uv。2. 使用 claude mcp add-json 命令添加 MCP 服务器，配置环境变量（GROK_API_URL 和 GROK_API_KEY 必填，Tavily 可选）。3. 验证安装：运行 claude mcp list 查看连接状态。
claude_desktop_config.json
{
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/GuDaStudio/GrokSearch@grok-with-tavily",
"grok-search"
],
"env": {
"GROK_API_URL": "https://your-api-endpoint.com/v1",
"GROK_API_KEY": "your-grok-api-key",
"TAVILY_API_KEY": "tvly-your-tavily-key",
"TAVILY_API_URL": "https://api.tavily.com"
}
}
选型与风险
不适合谁
- 未配置 Grok API 的用户（必需）
- 仅需简单网页抓取而不想配置额外服务的用户
- 对隐私敏感、不希望外部 API 介入的用户
所需权限
- 需要 Grok API 密钥和 Tavily API 密钥（可选）
- 需要访问网络以调用外部 API
- 可修改项目级 .claude/settings.json 文件（用于禁用内置工具）
风险与副作用
- 依赖第三方服务（Grok、Tavily），可能产生 API 费用
- Grok 搜索可能返回不准确信息，需人工验证
- 自动禁用内置工具可能影响其他功能
常见排障
- 1. 确认 GROK_API_URL 和 GROK_API_KEY 已正确设置且 API 兼容 OpenAI 格式。
- 2. 遇到 SSL 错误时，在 uvx 参数中添加 --native-tls。
- 3. 使用 get_config_info 工具检查配置状态并测试连接。
- 4. 查看日志（默认目录为 logs）以获取错误详情。
使用场景
在 Claude Code 中获取实时网络信息，如最新新闻、技术文档更新。
让 LLM 主动调用搜索工具获取官方文档，降低幻觉率。
抓取特定网页内容并转换为 Markdown 供模型阅读。
映射网站结构以便模型理解网站布局。
支持客户端
Claude Desktop完整支持
Cherry Studio完整支持