Claude MCP的X工具
一个轻量级的开源工具包，使克劳德能够使用自然语言高效搜索推特，并根据用户意图显示结果。专为原始数据查看和可选分析而设计。
特性
- 自然语言搜索：让克劳德用简单的英语搜索推特
- Twitter搜索：使用自然语言或高级Twitter语法搜索推文
- 专业格式化：干净、标记格式的推文显示
- 灵活的输出：显示原始推文或根据您的要求添加分析
- 高级过滤：按关键字、用户、日期、参与度指标等查找推文
- 分页支持：需要时每次搜索检索超过默认值的20条推文
安装
先决条件
- Node.js v16+
- Claude桌面版
- 免费RapidAPI密钥，可访问“the Old Bird API”（Twitter154）端点
RapidAPI密钥设置
- 访问 RapidAPI上的老鸟API
- 如果您没有RapidAPI帐户，请注册一个
- 订阅API（有可用的免费层）
- 订阅后，从仪表板复制RapidAPI密钥
设置步骤
- 克隆此存储库:
git clone https://github.com/0xGval/twitter-X-mcp-server
cd twitter-X-mcp-tools- 安装依赖项:
npm install- 创建配置:
- 复制 mcp.json.example 向 mcp.json 在您的Claude Desktop目录中 - 编辑 mcp.json 包含您的RapidAPI密钥和正确的文件路径
{
"mcpServers": {
"x-tools": {
"command": "node",
"args": ["YOUR_ABSOLUTE_PATH_TO/main.js"],
"env": {
"RAPIDAPI_KEY": "your_rapidapi_key"
}
}
}
}- 为桌面配置Claude:
- 在Windows上：放置您的 mcp.json 文件在 %APPDATA%\Claude\ - 在macOS上：放置您的 mcp.json 文件在 ~/Library/Application Support/Claude/ - 复制 claude-rules.md 和 knowledge/TwitterSearchSyntaxGuide.txt 到您的Claude知识库目录 - 重新启动Claude Desktop以使更改生效
可用工具
Twitter搜索
该工具主要设计用于自然语言。只需让克劳德在推特上搜索一些东西，它就会解释你的请求。
searchTwitter(query: "keyword", section: "latest", limit: 20)使用自然语言或高级语法搜索推特：
query：搜索查询（支持Twitter的高级搜索运算符）section：“最新”或“顶级”结果（默认值：“latest”）limit：要返回的推文数（默认值：20）
自然语言示例
简单查询
问克劳德：
Show me recent tweets about artificial intelligence以用户为中心的查询
问克劳德：
Find the latest tweets from Elon Musk that mention SpaceX复杂自然查询
问克劳德：
Search for tweets about climate change with at least 100 likes from the past month分析请求
问克劳德：
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:100climate action min_retweets:50 -filter:retweets所需文件
此工具包括几个必须正确设置的重要文件：
- main.js：主应用程序文件
- 工具/twitter.js：推特搜索实施
- claude-rules.md：Claude正确显示搜索结果的说明
- 知识/推特搜索SyntaxGuide.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-rules.md包括灵活的输出指令 - 缺少文件：验证
claude-rules.md和TwitterSearchSyntaxGuide.txt已正确添加到您的克劳德规则和知识库中
发展
要修改该工具，请执行以下操作：
- 编辑中的文件
tools/目录 - 更新中的格式
formatTwitterResults()功能（如果需要） - 重新启动Claude for Desktop以查看更改
许可证
该项目根据MIT许可证获得许可。
致谢
- Anthropic的模型上下文协议（MCP）
- 快速 API Twitter154 API
- 阿西奥斯
- 萨德
______________________________________________________________________
备注：此工具旨在与Claude AI助手配合使用，并根据用户意图为Twitter搜索结果提供灵活的显示选项。