x-search-mcp
MCP服务器，使Claude Desktop/Claude Code能够通过xAI（Grok）API实时搜索X（Twitter）。
设计理念
此服务器公开了一个单一的、灵活的 grok_search 工具与 没有硬编码的提示调用者（Claude或任何MCP客户端）自由地制作提示——决定搜索策略、输出格式和语言。这很有效，因为像Claude这样的人工智能模型可以动态地为每个用例生成最佳提示。
Grok搜索中的引用与响应文本一起返回，因此调用者可以通过获取特定的帖子URL或源页面来获取完整内容。
工具
| 工具 | 目的 |
|---|---|
grok_search | 通过Grok搜索X和/或网络。呼叫者通过 prompt 参数。 |
参数
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
prompt | 是 | -- | 要发送给Grok的指令/查询。包括搜索意图、所需的输出格式、语言、约束——任何东西。 |
enable_x_search | -- | true | 启用X（推特）搜索 |
enable_web_search | -- | false | 启用网络搜索 |
from_date | -- | -- | 搜索开始日期(YYYY-MM-DD) |
to_date | -- | 今天 | 搜索结束日期(YYYY-MM-DD) |
allowed_handles | -- | -- | 将X搜索限制为这些句柄（最多10个，没有 @) |
excluded_handles | -- | -- | 从X搜索中排除这些句柄（最多10个，没有 @) |
enable_image_understanding | -- | false | 在X搜索结果中启用图像理解 |
enable_video_understanding | -- | false | 在X搜索结果中启用视频理解 |
temperature | -- | 0.3 | Grok温度 |
设置
1.获取xAI API密钥
注册地址： https://console.x.ai/ 并获得API密钥。 按需付费定价（每次通话约0.05-0.15美元）。提前添加积分。
安全：永远不要提交API密钥。添加配置文件(claude_desktop_config.json,.mcp.json)to.gitignore或者通过环境变量管理密钥。
2.安装
git clone https://github.com/Mitachi-H/x-search-mcp.git
cd x-search-mcp
npm install
npm run build3a。与Claude Desktop一起使用（推荐）
添加以下内容 claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"x-search": {
"command": "node",
"args": ["/path/to/x-search-mcp/dist/index.js"],
"env": {
"XAI_API_KEY": "xai-xxxxxxxxxxxx"
}
}
}
}替换 /path/to/ 与实际路径。重新启动克劳德桌面。然后在对话中说“搜索X…”，工具就会自动调用。
3b。与Claude Code一起使用
# Add to your project's .mcp.json
cat > .mcp.json **备注**：响应API `x_search` / `web_search` 建议使用grok-4系列工具。
## API
此服务器使用xAI **响应API** (`/v1/responses`)服务器端 `x_search` / `web_search` 工具。
旧的聊天完成API `search_parameters` 已于2026年1月12日删除，因此这是正确的方法。
## 建筑
Claude (Desktop / Code) └─ MCP (stdio) └─ x-search-mcp (this server) └─ xAI API (api.x.ai) └─ Grok searches X in real time
克劳德本身无法有效地搜索X，但由xAI（X背后的公司）创建的Grok擅长搜索和总结X帖子。
此MCP服务器充当桥梁，使用Grok作为Claude的搜索层。
## 致谢
- [HayattiQ/x研究技能](https://github.com/HayattiQ/x-research-skills) --原创设计灵感
- [统计家伙/grok搜索mcp](https://github.com/stat-guy/grok-search-mcp) --参考MCP服务器实现
- [xAI API 文档](https://docs.x.ai/) --官方xAI API文档
## 许可证
[麻省理工学院](LICENSE)