项目简介

Grok-MCP 是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在将 xAI Grok API 的强大功能集成到支持 MCP 的大型语言模型 (LLM) 客户端中，例如 Claude Desktop。它通过标准化的 JSON-RPC 协议，将 Grok 的各项能力（如多模型聊天、图像理解、图像生成、实时网络搜索和高级推理）作为可调用的工具提供给LLM客户端，极大扩展了LLM的应用场景。

主要功能点

多模型支持：无缝访问 Grok-4、Grok-4-Fast、Grok-3-Mini 等多种 Grok 模型。
图像生成：根据文本描述，使用 Grok 的图像生成模型创作图片。
视觉理解：利用 Grok 的视觉模型分析图片内容，回答关于图片的问题。
实时网络搜索：进行实时网页搜索，并提供来自新闻、网站、X (Twitter) 和 RSS 订阅的引用来源。
高级推理：利用 Grok-3-Mini 和 Grok-4 等模型进行复杂问题的深入思考和推理。
状态化会话：通过 xAI 服务器维护对话上下文，支持跨请求的持久化会话。
会话历史管理：可选择开启或关闭会话历史功能，以在多轮对话中保持上下文。

安装步骤

克隆仓库：

git clone https://github.com/merterbak/Grok-MCP.git
cd Grok-MCP

创建虚拟环境：

uv venv
source .venv/bin/activate

安装依赖：

uv pip install -e .
# 或者同步所有依赖
# uv sync --all-extras

配置API密钥：请确保您的 xAI API 密钥已通过环境变量 'XAI_API_KEY' 设置，或者在项目根目录下的 '.env' 文件中添加 'XAI_API_KEY="your_api_key_here"'。

服务器配置

MCP服务器是为MCP客户端（如Claude Desktop）提供服务的。客户端需要配置服务器的启动命令和参数。以下是一个针对Claude Desktop的示例配置说明，您需要将以下信息添加到您的Claude Desktop配置文件中，并根据您的实际安装路径调整 'args' 中的 '/path/to/Grok-MCP'。

配置示例说明 (JSON 格式):

'mcpServers': 根对象，包含所有 MCP 服务器的配置。
'grok': 您为这个 Grok-MCP 服务器指定的名称。
'command': 启动 MCP 服务器的命令，这里使用 'uv' 包管理器。
'args': 传递给 'uv' 命令的参数列表，指定了服务器代码的目录和启动文件 ('main.py')。请确保将 '/path/to/Grok-MCP' 替换为您的 'Grok-MCP' 仓库的实际绝对路径。
'env': 环境变量，用于设置 'XAI_API_KEY'。请务必替换为您的真实 xAI API 密钥。

{
  "mcpServers": {
    "grok": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Grok-MCP", 
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "XAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

基本使用方法

配置完成后，MCP客户端会自动通过上述命令启动Grok-MCP服务器。如果您想手动启动服务器进行测试或开发：

Stdio模式：在项目根目录下运行以下命令：

uv run python main.py

Docker模式：如果您有Docker环境，可以在项目根目录下运行：
```
docker compose up --build
```

服务器启动后，您的MCP客户端将能够发现并使用 Grok-MCP 提供的所有工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息