← 返回目录

Grok Search MCP

社区

为 Claude Code 提供 Grok 强大实时搜索能力的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 1.9k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 7 个月前 ⚠
工具数: 8

48FMRS · D

该项目提供双引擎搜索（Grok + Tavily），功能丰富，安装简便，适合 Claude Code 用户。优势在于智能搜索和自动降级机制，但依赖外部 API 且需配置密钥。

最强项 · 文档质量 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

10/20

文档质量

12/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 源码显示使用了FastMCP构建，工具定义与README描述基本一致，但未看到测试或CI配置来验证关键路径，因此可靠性只能给到8分。
安全与权限 8/20: API密钥通过环境变量传入，README中有脱敏示例，未发现硬编码密钥。但工具toggle_builtin_tools会修改项目配置文件，需谨慎评估权限。安全给8分。
维护活跃度 10/20: 仓库活跃，有1841星和25个开放issue，但未看到明确的发布节奏或依赖更新策略，维护给10分。
文档质量 12/20: README详细，有安装、配置、工具参数说明，但缺少故障排查和成本说明，文档给12分。
安装易用性 10/20: 提供了一键安装命令和客户端配置示例，但依赖uvx和git安装，可能对Windows用户不友好，setup给10分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络

适合谁

需要实时搜索能力的 Claude Code 用户
希望减少 LLM 幻觉、获取最新信息的开发者
需要网页抓取和站点映射功能的研究人员

不适合谁

未配置 Grok API 的用户（必需）
仅需简单网页抓取而不想配置额外服务的用户
对隐私敏感、不希望外部 API 介入的用户

所需权限

需要 Grok API 密钥和 Tavily API 密钥（可选）
需要访问网络以调用外部 API
可修改项目级 .claude/settings.json 文件（用于禁用内置工具）

风险与副作用

依赖第三方服务（Grok、Tavily），可能产生 API 费用
Grok 搜索可能返回不准确信息，需人工验证
自动禁用内置工具可能影响其他功能

安装接入

准备工作

运行环境：Python 3.10+ · 预编译二进制

GROK_API_URL 必填必填，Grok API 地址，需为 OpenAI 兼容格式（支持 /chat/completions 和 /models）。

GROK_API_KEY 必填密钥必填，Grok API 密钥，从你的 Grok 服务或镜像站获取。

TAVILY_API_KEY 可选密钥可选，Tavily API 密钥，在 tavily.com 注册获取，用于 web_fetch / web_map。

FIRECRAWL_API_KEY 可选密钥可选，Firecrawl API 密钥，Tavily 抓取失败时托底使用。

其他可选配置项（10 个）

GROK_MODEL 可选可选，默认模型，默认值 grok-4-fast，设置后优先于配置文件。

TAVILY_API_URL 可选可选，Tavily API 地址，默认 https://api.tavily.com。

TAVILY_ENABLED 可选可选，是否启用 Tavily，默认 true。

FIRECRAWL_API_URL 可选可选，Firecrawl API 地址，默认 https://api.firecrawl.dev/v2。

GROK_DEBUG 可选可选，调试模式开关，默认 false。

GROK_LOG_LEVEL 可选可选，日志级别，默认 INFO。

GROK_LOG_DIR 可选可选，日志目录，默认 logs。

GROK_RETRY_MAX_ATTEMPTS 可选可选，最大重试次数，默认 3。

GROK_RETRY_MULTIPLIER 可选可选，重试指数退避乘数，默认 1。

GROK_RETRY_MAX_WAIT 可选可选，重试最大等待秒数，默认 10。

安装 Python 3.10+ 和 uv。
使用 claude mcp add-json 命令添加 MCP 服务器，配置环境变量（GROK_API_URL 和 GROK_API_KEY 必填，Tavily 可选）。
验证安装：运行 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"
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

生成并校验客户端配置

验证是否装好

运行 claude mcp list 确认 grok-search 连接成功，然后在对话中说"显示 grok-search 配置信息"，get_config_info 会测试 Grok API 连接并返回响应时间和可用模型列表。

常见排障

1. 确认 GROK_API_URL 和 GROK_API_KEY 已正确设置且 API 兼容 OpenAI 格式。
2. 遇到 SSL 错误时，在 uvx 参数中添加 --native-tls。
3. 使用 get_config_info 工具检查配置状态并测试连接。
4. 查看日志（默认目录为 logs）以获取错误详情。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 grok-search 搜索 FastAPI 官方文档中最新的 middleware 用法
获取刚才那次 web_search 返回的 session_id 对应的信源列表
抓取 https://docs.astral.sh/uv/ 的页面内容并转成 Markdown
调用 grok-search toggle_builtin_tools，关闭 Claude Code 内置的 WebSearch 和 WebFetch

工具能力 8

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 只读

提供结构化搜索规划脚手架，用于在执行复杂搜索前生成可执行的搜索计划。

使用场景

在 Claude Code 中获取实时网络信息，如最新新闻、技术文档更新。

让 LLM 主动调用搜索工具获取官方文档，降低幻觉率。

抓取特定网页内容并转换为 Markdown 供模型阅读。

映射网站结构以便模型理解网站布局。

支持客户端

Claude Desktop

Cherry Studio

依据项目文档列出，未经本站实测。

详细介绍

Grok Search MCP 是一个基于 FastMCP 构建的 MCP 服务器，采用双引擎架构：Grok 负责 AI 驱动的智能搜索，Tavily 负责高保真网页抓取与站点映射，各取所长为 Claude Code / Cherry Studio 等 LLM 客户端提供完整的实时网络访问能力。