AI导哈

X搜索服务

一个通过xAI（Grok）API实现Claude Desktop/Claude Code实时搜索X（Twitter）内容的MCP服务器。

  • by Mitachi-H
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Mitachi-H/grok-search-mcp_skills

使用说明

x-search-mcp

日语版README在这里

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 build

3a。与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 << 'EOF'
{
  "mcpServers": {
    "x-search": {
      "command": "node",
      "args": ["/path/to/x-search-mcp/dist/index.js"],
      "env": {
        "XAI_API_KEY": "xai-xxxxxxxxxxxx"
      }
    }
  }
}
EOF

要注册为Claude Code技能，请参阅 SKILL.md 在存储库根目录中。

环境变量

变量 必填 默认 描述
XAI_API_KEY 是 -- xAI API密钥
XAI_BASE_URL -- https://api.x.ai/v1 API终点
XAI_MODEL -- grok-4-1-fast 要使用的模型（建议用于响应API的grok-4系列）

使用示例

克劳德根据您的要求自动制作最佳的Grok提示：

  • “X上的AI代理有什么趋势？”——克劳德称 grok_search 提示Grok查找具有参与度指标和URL的热门AI代理帖子
  • “给我看看@hayattiq最近关于MCP的帖子”——克劳德使用 grok_search 随着 allowed_handles: ["hayattiq"] 以及为用户帖子搜索量身定制的提示
  • “为我正在写的一篇文章研究克劳德密码的X话语”——克劳德用 enable_web_search: true 全面采购
  • “用英语在X上搜索对OpenAI最新公告的反应”——Claude直接在提示中包含语言偏好

工作流程：深入研究并跟进引文

  1. 克劳德打电话来 grok_search 查找相关帖子和讨论
  2. Grok返回带有引用URL的结果
  3. 然后，Claude可以获取特定的引用URL（通过网络搜索或网络获取），以获取完整的帖子内容或源页面
  4. Claude将全文内容综合为综合分析

选型指南

型号 速度 成本 用例
grok-4-1-fast 快速 正常 日常搜索（默认，推荐）
grok-4-1-fast-reasoning 正常 高 复杂趋势分析（带推理）
grok-4 慢 高 最高质量分析

备注：响应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的搜索层。

致谢

许可证

麻省理工学院

相关 MCP