Claude MCP 的 X 工具

一个轻量级的开源工具包，使 Claude 能够使用自然语言高效地搜索 Twitter，并根据用户意图显示结果。专为原始数据查看和可选分析而设计。

功能

• 自然语言搜索：要求 Claude 用简单的英语搜索 Twitter
• Twitter 搜索：使用自然语言或高级 Twitter 语法搜索推文
• 专业格式：干净的、markdown 格式的推文显示
• 灵活的输出：显示原始推文或根据您的要求添加分析
• 高级过滤：按关键词、用户、日期、互动指标等查找推文
• 分页支持：在需要时检索超过默认的每次搜索 20 条推文

安装

前提条件

• Node.js v16+
• Claude Desktop
• 具有访问 "The Old Bird API" (Twitter154) 端点的免费 RapidAPI 密钥

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 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 密钥：确保您的 RapidAPI 密钥在 mcp.json 中正确设置
• 路径错误：确保您在 Windows 中使用带有适当转义符 (\\) 的完整绝对路径
• 没有结果：检查您的搜索查询是否有效且不太严格
• Claude 行为问题：确保您拥有最新版本的 claude-rules.md，其中包含灵活的输出说明
• 缺少文件：验证 claude-rules.md 和 TwitterSearchSyntaxGuide.txt 是否已正确添加到您的 Claude 规则和知识库

开发

要修改该工具：

1. 编辑 tools/ 目录中的文件
2. 如果需要，更新 formatTwitterResults() 函数中的格式
3. 重新启动 Claude Desktop 以查看更改

许可证

该项目根据 MIT 许可证获得许可。

致谢

• Anthropic 的模型上下文协议 (MCP)
• RapidAPI Twitter154 API
• Axios
• Zod

---

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