用途
Grok-MCP 是一个基于 MCP 协议的开源服务器，旨在让 MCP 客户端（如 Claude Desktop、Claude Code）通过标准化接口调用 xAI 的 Grok API。它把 Grok 的多种能力包装成可被 AI 代理调用的工具，适合希望在现有 AI 助手工作流中集成 Grok 推理、搜索、图像和文件处理能力的开发者。
主要能力
- 智能体工具调用：支持网络搜索、X（Twitter）搜索、代码执行及图像生成，并可进行多步推理。
- 多模型访问：可调用 grok-4.6、grok-4.5、grok-build-0.1 等最新模型。
- 图像与视频生成：使用 Grok Imagine 创建或编辑图像（支持多参考编辑）、生成视频，并可扩展现有视频。
- 视觉能力：用 Grok 视觉模型分析本地或远程图像。
- 文件 API：上传、管理并与文档对话。
- 有状态对话：通过 response_id 在多次请求间保持上下文。
- 本地聊天历史：可选地将客户端聊天历史保存为 chats/ 下的 JSON 文件。
使用方式
要求 Python 3.11 或更高版本，以及一个 xAI API 密钥。基本步骤：克隆仓库、创建虚拟环境、安装依赖。
集成到 Claude Desktop：在 Claude Desktop 配置文件中添加相应配置。
集成到 Claude Code：在项目目录内运行相关命令，或使用包含密钥的 .env 文件；可运行验证命令确认注册成功。
可选的文件系统 MCP：Claude Desktop 无法将聊天中上传的图片直接发送给 MCP 工具，可借助官方 Filesystem MCP 服务器，之后在聊天中写入图片文件路径（如 /Users/mert/Desktop/image.png），Claude 即可在视觉聊天工具中使用它。
可用工具示例（每个工具在 src/server.py 中有完整文档字符串）：
- 聊天与推理：chat、chat_with_vision、chat_with_files、stateful_chat、retrieve_stateful_response、delete_stateful_response、web_search、x_search、code_executor、grok_agent。
- 图像与视频：generate_image（save=true 可写入 images/）、generate_video、extend_video。
- 文件管理：upload_file、list_files、get_file、get_file_content、delete_file。
- 本地聊天历史：list_chat_sessions、get_chat_history、clear_chat_history。
- 模型列表：list_models（列出所有 Grok 语言和图像模型及实时定价）。
注意：使用图像和文件时，必须向聊天提供路径。
适用场景
- 在 Claude Desktop / Claude Code 中增强 Grok 的多模态推理与生成能力。
- 需要联网搜索、X 搜索或代码执行的自动化任务。
- 需要将图像、视频生成和文件问答集成到 AI 代理流程。
- 需要保持对话状态或保存本地聊天记录的开发与调试。
限制
- 需要 Python 3.11+ 和有效的 xAI API 密钥。
- 图像和文件操作依赖提供本地路径，Claude Desktop 需额外配置 Filesystem MCP。
- 该项目采用 MIT 许可证开源；具体定价以 list_models 返回的实时信息为准。其他收费、平台或效果细节暂未提供。
