twitter-X-mcp-server

🚀 X 工具适用于 Claude MCP

X 工具是一个轻量级、开源的工具包，专为 Claude 设计。它能让 Claude 高效地运用自然语言搜索 Twitter，并依据用户意图展示搜索结果。此外，该工具还支持查看原始数据和进行可选分析。

🚀 快速开始

X 工具能帮助 Claude 实现自然语言搜索 Twitter 的功能，你可以按照以下步骤完成安装设置，然后开始使用。

✨ 主要特性

• 自然语言搜索：可使用日常语言让 Claude 搜索 Twitter。
• Twitter 搜索：既可以通过自然语言，也能利用高级 Twitter 语法搜索推文。
• 专业格式：以干净的 Markdown 格式显示推文。
• 灵活输出：既能显示原始推文，也能根据需求添加分析内容。
• 高级筛选：能按关键词、用户、日期、互动指标等条件查找推文。
• 分页支持：可获取超过默认 20 条推文的搜索结果。

📦 安装指南

先决条件

• Node.js v16+
• Claude for Desktop
• RapidAPI 的免费密钥，且该密钥需具有访问“Twitter154 API”的权限

设置步骤

1. 编辑 mcp.json 文件：

{
    "api_key": "your_rapidapi_key",
    "tools": {
        "x_tools": "path/to/xTools.js"
    }
}

2. 安装依赖项：

npm install axios zod

3. 重启 Claude Desktop 完成设置

💻 使用示例

基础用法

在 formatTwitterResults() 函数中，可根据需求调整输出格式。例如：

function formatTwitterResults(results) {
    return results.map(tweet => 
        `标题：${tweet.title}\n链接：${tweet.url}\n内容：${tweet.content}`
    ).join('\n\n');
}

📚 详细文档

搜索语法

支持以下高级筛选条件：

• 用户名：
  • from:username — 来自特定用户的推文
  • to:username — 发送给特定用户的推文
• 媒体类型：
  • filter:links — 包含链接的推文
  • filter:images — 包含图片的推文
• 日期范围：
  • since:YYYY-MM-DD — 推文发布时间早于该日期
  • until:YYYY-MM-DD — 推文发布时间晚于该日期

常见问题解决

1. API 密钥错误：确认 mcp.json 中的密钥是否正确配置。
2. 路径问题：使用正确的绝对路径，并在 Windows 系统中使用反斜杠（如 C:\\path）。
3. 无搜索结果：检查查询条件是否有效且不过于严格。

开发指南

1. 修改工具文件夹中的代码。
2. 更新 formatTwitterResults() 函数的输出格式。
3. 重启 Claude Desktop 以应用更改。

📄 许可证

本项目在 MIT 许可证下开源。

致谢

感谢以下项目的贡献：

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