Grok2api MCP Server

Grok2API MCP服务器

英语 · 中文

一 MCP（模型上下文协议） 通过以下方式提供实时网络搜索的服务器 格罗克。返回结构化结果，包括源URL、置信度得分、关键点和多语言支持。

运作原理

Claude / Cursor / etc.  ──MCP──>  grok-mcp-server  ──HTTP──>  grok2api  ──>  Grok

此服务器将MCP客户端桥接到 grok2api-兼容后端，通过兼容OpenAI的API公开Grok的实时网络搜索。

特性

• 实时网络和推特/X搜索 通过Grok
• 结构化JSON输出 --摘要、引用要点、来源列表、置信度评分
• 多种输出模式 — brief, analyst, raw
• 多语言支持 --用任何语言回答
• 时间范围过滤 — 24h, 7d, 30d, all
• 源头新鲜度控制 --更喜欢最近的来源
• 域分配首选项 --优先考虑受信任的域（尽最大努力）
• 自动重试 指数回退
• 运行时指标 通过 grok_stats 工具

先决条件

你需要跑步 grok2api 实例（或由具有网络搜索的Grok模型支持的任何与OpenAI兼容的API端点）。

设置grok2api后端

强烈建议为此使用辅助/alt-Grok帐户，而不是您的主帐户。

1.部署grok2api

选择适合您环境的方法：

VPS / Server (Docker Compose — recommended)

需要 码头工人 Docker Compose已安装在您的服务器上。

git clone https://github.com/chenyme/grok2api
cd grok2api
docker compose up -d

管理面板将在 http://your-server-ip:8000/admin （默认密码： grok2api).

macOS (local)

需要Python 3.11+和 紫外线.

# Install uv if you don't have it
brew install uv

# Clone and run
git clone https://github.com/chenyme/grok2api
cd grok2api
uv sync
uv run main.py

管理面板将位于 http://localhost:8000/admin （默认密码： grok2api).

Windows (local)

需要Python 3.11+和 紫外线.

# Install uv (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone and run
git clone https://github.com/chenyme/grok2api
cd grok2api
uv sync
uv run main.py

管理面板将位于 http://localhost:8000/admin （默认密码： grok2api).

Linux (local, without Docker)

需要Python 3.11+和 紫外线.

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and run
git clone https://github.com/chenyme/grok2api
cd grok2api
uv sync
uv run main.py

管理面板将位于 http://localhost:8000/admin （默认密码： grok2api).

有关云部署（Vercel、Render），请参见 grok2api 阅读.

2.拿你的Grok饼干

1. 登录 grok.com 使用您的Grok帐户
2. 打开浏览器DevTools(F12 或 Cmd+Opt+I)
3. 去 应用 标签
4. 在左侧边栏中，展开 存储→ Cookie
5. 查找名为的cookie sso 或 sso-rw
6. 复制其值

3.向grok2api添加Token

1. 打开grok2api管理面板(http://your-server:8000/admin)
2. 点击 添加 添加新令牌
3. 粘贴您刚才复制的cookie值
4. 根据您的Grok订阅选择您的帐户类型：

- 基本 --每20小时80个请求 - 超级 --每2小时140个请求

这 GROK_API_KEY 在你的 .env 是否在grok2api中配置了管理密钥（ app.app_key 默认值： grok2api).

安装

选项A：全局安装（推荐）

git clone https://github.com/wousp112/grok2api-mcp-server.git
cd grok-mcp-server
cp .env.example .env
# Edit .env with your API URL and key
npm install
npm link

选项B：本地安装

git clone https://github.com/wousp112/grok2api-mcp-server.git
cd grok-mcp-server
cp .env.example .env
# Edit .env with your API URL and key
npm install

配置

复制 .env.example 到 .env 并填写您的值：

MCP客户端配置

Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "grok-search": {
      "command": "grok-mcp-server",
      "args": [],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "grok-search": {
      "command": "grok-mcp-server",
      "args": []
    }
  }
}

Cursor

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "grok-search": {
      "command": "grok-mcp-server",
      "args": []
    }
  }
}

注： 如果你跳过 npm link，请改用完整路径： "command": "/path/to/grok-mcp-server/index.js"

工具

grok_web_search

通过Grok以结构化输出搜索网络或Twitter/X。

响应结构：

{
  "summary": "Concise factual summary",
  "key_points": [
    { "point": "Key finding", "source_urls": ["https://..."] }
  ],
  "sources": [
    {
      "title": "Article Title",
      "url": "https://...",
      "publisher": "Publisher Name",
      "published_at": "2025-01-01T00:00:00Z",
      "relevance_note": "Why this source matters"
    }
  ],
  "confidence": 0.85,
  "as_of": "2025-01-01T12:00:00Z",
  "notes": "Additional context or caveats"
}

grok_stats

返回运行时指标：调用计数、错误分布、正常运行时间。

致谢

• grok2api 通过chenyme-使Grok可以通过与OpenAI兼容的API访问的后端

许可证

麻省理工学院