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
• 擁有訪問“Twitter154 API”權限的 RapidAPI 免費密鑰

設置步驟

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