X 工具用于 Claude MCP

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

功能

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

安装

先决条件

• Node.js v16+
• Claude 桌面版
• 具有访问 "The Old Bird API"（Twitter154）端点权限的免费 RapidAPI 密钥

RapidAPI 密钥设置

1. 访问 The Old Bird API on RapidAPI
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 桌面目录中的 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 桌面版：

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

可用工具

Twitter 搜索

该工具主要用于与自然语言一起使用。只需让 Claude 在 Twitter 上搜索某物，它会解释您的请求。

searchTwitter(query: "关键词", section: "最新", limit: 20)

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

• query：搜索查询（支持 Twitter 的高级搜索运算符）
• section："最新" 或 "热门" 结果（默认："最新"）
• limit：返回的推文数量（默认：20）

自然语言示例

简单查询

询问 Claude：

给我看看最近关于人工智能的推文

用户聚焦查询

询问 Claude：

找到最近 Elon Musk 发布的提到 SpaceX 的推文

复杂自然查询

询问 Claude：

搜索过去一个月内至少有 100 个赞的关于气候变化的推文

分析请求

询问 Claude：

基于最近的推文，新比特币 ETF 的情绪如何？

直接语法示例

对于喜欢直接语法的人：

from:elonmusk spacex since:2023-01-01

"人工智能" filter:images min_faves:1

气候行动 min_retweets:50 -filter:retweets

必要文件

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

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

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

搜索语法

该工具支持所有标准的 Twitter 搜索运算符，Claude 可以从您的自然语言中应用这些运算符：

用户

• from:用户名 - 特定账户发送的推文
• to:用户名 - 回复特定账户的推文
• @用户名 - 提及该账户的推文

媒体和链接

• 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 桌面版以查看更改

许可证

本项目采用 MIT 许可证。

致谢

• Anthropic 的 Model Context Protocol (MCP)
• RapidAPI Twitter154 API
• Axios
• Zod

---

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