AI导哈

X搜索MCP服务器

利用xAI的Responses API和x_search服务器端工具，为MCP兼容客户端提供实时搜索X（Twitter）帖子的功能。

  • by toocheap
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 toocheap/x-search-mcp

使用说明

X（推特）搜索MCP服务器

xAI的 响应API + x_search服务器端工具是可以利用MCP对应客户端实时检索X（Twitter）投稿的MCP服务器。

机能

｜工具名称｜功能｜ |---|---| | x_search_posts 在关键硬件主题中搜索X帖子 | x_get_user_posts 获取特定用户的最近帖子（allowed_x_handles 缩小范围） | x_get_trending 获取趋势主题

支持的客户端

只要是支持stdio传输的MCP客户端就可以使用。以下是一些典型的例子：

｜客户端｜种类｜ |---|---| | 克劳德桌面版 桌面应用程序 | 克劳德代码 |CLI| | 光标 代码编辑器 | 帆板运动 代码编辑器 | VS代码（GitHub副本） 代码编辑器 | 克莱恩 | VS Code扩张| | Roo代码 | VS Code扩张| | 樱桃工作室 桌面应用程序 | 5ire 桌面应用程序

其他支持MCP的客户端 MCP Clients 一覧 来修改标记元素的显示属性。

安装，安装

前提条件

  • Python 3.10 以上
  • xAI API密钥（https://console.x.ai/），模板名称将采用不同的格式

1.克隆存储库并创建虚拟环境

git clone https://github.com/toocheap/x-search-mcp.git
cd x-search-mcp

# 仮想環境を作成
python3 -m venv .venv

# 仮想環境を有効化
# macOS / Linux:
source .venv/bin/activate
# Windows:
# .venv\Scripts\activate

# 依存パッケージをインストール
pip install -r requirements.txt

2.查看虚拟环境的Python路径

设置MCP客户端需要完整路径。请使用以下命令确认：

# macOS / Linux（venv を有効化した状態で）
which python3
# 例: /Users/yourname/src/x-search-mcp/.venv/bin/python3

# Windows
# where python
# 例: C:\Users\yourname\src\x-search-mcp\.venv\Scripts\python.exe

3.MCP客户端设置

大多数MCP客户端都支持相同的JSON格式设置。 请将以下内容添加到客户机的MCP设置中：

{
    "mcpServers": {
        "x_search": {
            "command": "/absolute/path/to/x-search-mcp/.venv/bin/python3",
            "args": ["/absolute/path/to/x-search-mcp/x_search_mcp.py"],
            "env": {
                "XAI_API_KEY": "xai-xxxxxxxxxxxxxxxxxxxxxxxx"
            }
        }
    }
}

重要:

  • command 在 在步骤2中验证的虚拟环境的Python完整路径中所述修改相应参数的值。系统的 python3 不是，不是 .venv 使用里面的东西。
  • args 在 x_search_mcp.py 的，之绝对路径中所述修改相应参数的值。
  • XAI_API_KEY 在https://console.x.ai/中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
クライアント別の設定ファイルの場所

｜客户端｜设置文件｜ |---|---| |克劳德桌面（macOS）| ~/Library/Application Support/Claude/claude_desktop_config.json | |克劳德桌面（Windows）| %APPDATA%\Claude\claude_desktop_config.json | |克劳德代码| ~/.claude/settings.json 或 claude mcp add 命令 |光标|设置→ MCP → 添加服务器| |风帆|设置→ 高级设置→ Cascade| |VS代码（副本）|设置→ MCP → 在settings.json中编辑|

4.重新启动客户端

保存设置后，请重新启动客户端。识别MCP服务器，可以使用X检索工具。

使用例

只需在MCP客户机上进行以下对话：

  • “搜索关于AI的最新推特”
  • “让我看看@elonmusk最近的投稿”
  • “请告诉我在日本的趋势”
  • “用日语搜索#cybersecurity的推特”

体系结构

MCP Client <-> MCP Server (stdio) <-> xAI Responses API (/v1/responses)
                                            |
                                       x_search tool
                                      (server-side)
                                            |
                                       X (Twitter) data

这个服务器是xAI的 响应API 和 x_search服务器端工具中所述修改相应参数的值。 是Grok在服务器方面自主地检索·分析X，返回结果的代理性的结构。

旧 Live Search API (search_parameters）于2026年1月废止 正在使用新的代理工具API。

模型

x_search 服务器端工具 仅限grok-4系模型中所述修改相应参数的值。

｜模型｜特征｜ |---|---| | grok-4-1-fast ｜工具调用优化、高速（默认） | | grok-4-1-fast-reasoning 带推理、更高精度

修改模型 x_search_mcp.py 中的 XAI_MODEL 请编辑常量。

注意: grok-3 在系统模型中，x_search工具不可用（将出现400错误）。

故障排除

｜错误｜原因｜处理｜ |---|---|---| | Failed to spawn process: No such file or directory Python路径错误 .venv/bin/python3 全票 command 指定为 | status 400: model not supported 使用3系模型 XAI_MODEL 的 grok-4-1-fast （默认设置） | status 401 API密钥无效 XAI_API_KEY 查看项目中可用的所有族 | status 410: Live search is deprecated 使用旧API更新为最新版（git pull） |

对于Claude Desktop，可以在下面查看日志：

# macOS
cat ~/Library/Logs/Claude/mcp-server-x_search.log

料金

产生xAI API的使用费用。了解更多信息 xAI定价 来修改标记元素的显示属性。

许可证

麻省理工学院

相关 MCP