Grok MCP克劳德
Grok MCP服务器针对Claude Desktop进行了优化——使用xAI的Grok实现干净的单文件,用于实时web/X搜索和图像生成。
概念
克劳德想,格罗搜索。
Claude Desktop处理对话、记忆和推理。Grok提供了克劳德无法提供的东西——实时网络搜索、X(推特)搜索和图像/视频生成。

特性
| 工具 | 说明 |
|---|---|
grok_search | 实时网络和X(推特)搜索 |
grok_chat | 与视觉、文件和代码执行支持聊天 |
grok_agent | 结合搜索、代码执行、文件和图像的多工具代理 |
generate_image | 支持img2img的图像生成 |
generate_video | 支持img2video和video2video的视频生成 |
manage_files | 在xAI上上传、列出、检索和删除文件 |
需求
- Python 3.10+
- xAI API密钥
- 克劳德桌面版
安装
git clone https://github.com/yourname/grok-mcp-claude.git
cd grok-mcp-claude
pip install -r requirements.txt配置
添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"grok": {
"command": "python",
"args": ["/path/to/grok-mcp-claude/grok.py"],
"env": {
"XAI_API_KEY": "your-api-key-here"
}
}
}
}工具参考
grok_search
通过网络或X(推特)进行实时搜索。
| 参数 | 默认值 | 说明 |
|---|---|---|
prompt | 必填 | 搜索查询 |
platform | "web" | "web" 或 "x" |
model | DEFAULT_SEARCH_MODEL | 要使用的模型 |
allowed_targets | None | 域(web)或句柄(X)的白名单 |
excluded_targets | None | 域(网络)或句柄(X)的黑名单 |
from_date | None | 开始日期 DD-MM-YYYY (仅限X) |
to_date | None | 结束日期 DD-MM-YYYY (仅限X) |
include_inline_citations | False | 返回内联引用 |
______________________________________________________________________
grok_chat
具有可选愿景、文件和代码执行的通用聊天。
| 参数 | 默认值 | 说明 |
|---|---|---|
prompt | 必填 | 用户消息 |
model | DEFAULT_CHAT_MODEL | 要使用的模型 |
system_prompt | None | 系统提示 |
file_ids | None | 要附加的xAI文件ID |
image_paths | None | 本地映像路径 |
image_urls | None | 图像URL |
response_id | None | 有状态聊天的先前响应ID |
use_code_execution | False | 启用代码执行 |
______________________________________________________________________
grok_agent
多工具代理。自由组合网络搜索、X搜索、代码执行、文件和图像。
| 参数 | 默认值 | 说明 |
|---|---|---|
prompt | 必填 | 用户消息 |
model | DEFAULT_SEARCH_MODEL | 要使用的模型 |
use_web_search | False | 启用网络搜索 |
use_x_search | False | 启用X搜索 |
use_code_execution | False | 启用代码执行 |
allowed_targets | None | 域名或句柄白名单 |
excluded_targets | None | 域或句柄黑名单 |
file_ids | None | 要附加的xAI文件ID |
image_paths | None | 本地映像路径 |
image_urls | None | 图像URL |
system_prompt | None | 系统提示 |
include_inline_citations | False | 返回内联引用 |
max_turns | None | 最大搜索迭代次数 |
______________________________________________________________________
generate_image
生成图像。通过 image_path 或 image_url 对于img2img。
| 参数 | 默认值 | 说明 |
|---|---|---|
prompt | 必填 | 生成提示 |
model | DEFAULT_IMAGE_MODEL | 要使用的模型 |
n | 1 | 图像数量 |
image_path | None | img2img的本地图像 |
image_url | None | img2img的图像URL |
aspect_ratio | None | 例如。 "16:9", "1:1", "9:16" |
______________________________________________________________________
generate_video
从文本、图像或视频生成视频。
| 参数 | 默认值 | 说明 |
|---|---|---|
prompt | 必填 | 生成提示 |
model | DEFAULT_VIDEO_MODEL | 要使用的模型 |
image_path / image_url | None | img2video的源图像 |
video_path / video_url | None | video2video的源视频 |
duration | None | 持续时间(秒) |
aspect_ratio | None | 纵横比 |
resolution | None 决心 |
______________________________________________________________________
manage_files
管理xAI上的文件。
| 操作 | 必需参数 | 描述 |
|---|---|---|
upload | file_path | 上传文件 |
list | -- | 列出上传的文件 |
get_info | file_id | 获取文件元数据 |
get_content | file_id | 获取文件内容 |
delete | file_id | 删除文件 |
模型
DEFAULT_CHAT_MODEL = "grok-4-1-fast-non-reasoning"
DEFAULT_SEARCH_MODEL = "grok-4-1-fast-reasoning"
DEFAULT_IMAGE_MODEL = "grok-imagine-image"
DEFAULT_VIDEO_MODEL = "grok-imagine-video"许可证
麻省理工学院
