AI导哈

Grok MCP服务器

一个专为Claude Desktop优化的Grok MCP服务器，提供实时网络/X搜索和图像生成功能。

  • by yukincom
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 yukincom/grok-mcp-claude

使用说明

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上上传、列出、检索和删除文件

需求

安装

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"

许可证

麻省理工学院

相关 MCP