X Tools for Claude MCP

Claude MCP 版 X 工具

一款轻量级开源工具包，可让 Claude 通过自然语言高效搜索 Twitter，并根据用户意图显示结果。既适用于查看原始数据，也可选择进行分析。

功能

• 自然语言搜索：用通俗英语让 Claude 搜索 Twitter
• Twitter 搜索：使用自然语言或高级 Twitter 语法搜索推文
• 专业格式：以简洁的 Markdown 格式显示推文
• 灵活输出：显示原始推文，或根据你的要求补充分析
• 高级筛选：按关键词、用户、日期、互动指标等查找推文
• 分页支持：需要时，每次搜索可获取超过默认的 20 条推文

安装

前提条件

• Node.js v16+
• Claude for Desktop
• 可免费使用的 RapidAPI 密钥，并可访问“The Old Bird API”（Twitter154）端点

RapidAPI 密钥设置

1. 访问 RapidAPI 上的 The Old Bird API
2. 如果还没有 RapidAPI 账户，请注册一个
3. 订阅该 API（提供免费套餐）
4. 订阅后，从控制面板复制 RapidAPI 密钥

设置步骤

1. 克隆此代码库：

   git clone https://github.com/0xGval/twitter-X-mcp-server
   cd twitter-X-mcp-tools
   

2. 安装依赖项：

   npm install
   

3. 创建配置文件：

   • 将 mcp.json.example 复制到 Claude Desktop 目录中的 mcp.json
   • 编辑 mcp.json，填入 RapidAPI 密钥并设置正确的文件路径

   {
     "mcpServers": {
       "x-tools": {
         "command": "node",
         "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"],
         "env": {
           "RAPIDAPI_KEY": "your_rapidapi_key"
         }
       }
     }
   }
   

4. 配置 Claude for Desktop：

   • Windows：将 mcp.json 文件放入 %APPDATA%\Claude\
   • macOS：将 mcp.json 文件放入 ~/Library/Application Support/Claude/
   • 将 claude-rules.md 和 knowledge/TwitterSearchSyntaxGuide.txt 复制到 Claude 知识库目录
   • 重启 Claude Desktop 以使更改生效

可用工具

Twitter 搜索

此工具主要用于自然语言交互。只需让 Claude 搜索 Twitter 上的内容，它就会理解你的请求。

searchTwitter(query: "keyword", section: "latest", limit: 20)

使用自然语言或高级语法搜索 Twitter：

• query：搜索查询（支持 Twitter 的高级搜索运算符）
• section：结果类型为“latest”或“top”（默认：“latest”）
• limit：返回的推文数量（默认：20）

自然语言示例

简单查询

向 Claude 提问：

Show me recent tweets about artificial intelligence

针对用户的查询

向 Claude 提问：

Find the latest tweets from Elon Musk that mention SpaceX

复杂自然语言查询

向 Claude 提问：

Search for tweets about climate change with at least 100 likes from the past month

分析请求

向 Claude 提问：

What's the sentiment around the new Bitcoin ETF based on recent tweets?

直接语法示例

适合偏好直接使用语法的用户：

from:elonmusk spacex since:2023-01-01

"artificial intelligence" filter:images min_faves:100

climate action min_retweets:50 -filter:retweets

必需文件

此工具包含几个必须正确设置的重要文件：

• main.js：主应用程序文件
• tools/twitter.js：Twitter 搜索实现
• claude-rules.md：指导 Claude 以适当方式显示搜索结果的说明
• knowledge/TwitterSearchSyntaxGuide.txt：Twitter 搜索语法参考指南

请确保所有这些文件都放置在 Claude 配置中的正确位置。

搜索语法

此工具支持所有标准 Twitter 搜索运算符，Claude 可根据你的自然语言请求使用这些运算符：

用户

• from:username - 特定账户发布的推文
• to:username - 回复特定账户的推文
• @username - 提及该账户的推文

媒体和链接

• filter:media - 包含任意媒体的推文
• filter:images - 包含图片的推文
• filter:native_video - 包含视频的推文
• filter:links - 包含链接的推文

日期

• since:YYYY-MM-DD - 此日期之后的推文
• until:YYYY-MM-DD - 此日期之前的推文

互动

• min_retweets:n - 转推数至少为 n 的推文
• min_faves:n - 点赞数至少为 n 的推文
• min_replies:n - 回复数至少为 n 的推文

故障排除

常见问题：

• 未找到 API 密钥：确保已在 mcp.json 中正确设置 RapidAPI 密钥
• 路径错误：确保使用完整的绝对路径，并在 Windows 中正确转义（\\）
• 没有结果：检查搜索查询是否有效且限制条件不过于严格
• Claude 行为问题：确保使用的是最新版本的 claude-rules.md，其中包含灵活的输出说明
• 缺少文件：确认已将 claude-rules.md 和 TwitterSearchSyntaxGuide.txt 正确添加到 Claude 规则和知识库中

开发

要修改此工具：

1. 编辑 tools/ 目录中的文件
2. 根据需要更新 formatTwitterResults() 函数中的格式设置
3. 重启 Claude 桌面版以查看更改

许可证

本项目基于 MIT License 许可。

致谢

• Anthropic 的 Model Context Protocol（MCP）
• RapidAPI Twitter154 API
• Axios
• Zod

---

注意：此工具旨在与 Claude AI 助手配合使用，并根据用户意图提供具有灵活显示选项的 Twitter 搜索结果。