Twitter MCP Server

🚀 Twitter MCP 服務器用於 Claude Desktop

本項目是一個 Model Context Protocol (MCP) 服務器，它能讓 Claude Desktop 與 Twitter 實現交互。藉助該服務器，用戶可在 Claude Desktop 中完成發佈推文、分析推文內容，還能依據提示創作出結構完善的推文。

🚀 快速開始

此 MCP 服務器藉助 Twitter API 把 Claude Desktop 和 Twitter 連接起來，具備以下多種實用功能：

• 資源：可訪問您的 Twitter 個人資料、近期推文以及熱門話題。
• 工具：支持發佈推文、刪除推文，還能對推文內容進行分析。
• 提示：提供用於創作簡潔推文、Twitter 線程以及以吸引用戶參與為目標的內容模板。

✨ 主要特性

資源

• 用戶資料 (twitter://user/profile)：獲取有關您的 Twitter 資料的信息。
• 最近推文 (twitter://user/tweets)：檢索您最新的推文。
• 熱門話題 (twitter://trends)：獲取當前熱門話題。

工具

• 發佈推文：帶有內容驗證功能的新推文。
  • 參數：content（字符串，最多 280 字符），dryRun（可選布爾值）。
• 刪除推文：通過 ID 刪除推文。
  • 參數：tweetId（字符串）。
• 分析推文：檢查推文內容的參與度潛力。
  • 參數：content（字符串，最多 280 字符）。

提示

• 簡潔推文：創建簡短、專注的推文。
  • 參數：topic（字符串），include_hashtags（布爾值），tone（枚舉：專業，隨意，幽默）。
• Twitter 線程：生成多推文線程。
  • 參數：topic（字符串），points（數字，2 - 5），include_call_to_action（布爾值）。
• 參與推文：創建設計用於高參與度的推文。
  • 參數：topic（字符串），engagement_type（枚舉：問題，投票，熱門觀點，實用技巧）。

📦 安裝指南

先決條件

• Node.js（v16 或更高版本）
• Claude Desktop
• 帶有 API 密鑰的 Twitter 開發者賬戶

安裝步驟

1. 克隆或下載此倉庫

   git clone https://github.com/yourusername/twitter-mcp-server
   cd twitter-mcp-server
   

2. 安裝依賴項

   npm install
   

3. 在項目根目錄中創建一個 .env 文件，其中包含您的 Twitter API 憑據

   TWITTER_API_KEY=your_api_key
   TWITTER_API_SECRET=your_api_secret
   TWITTER_ACCESS_TOKEN=your_access_token
   TWITTER_ACCESS_SECRET=your_access_secret
   

📚 詳細文檔

與 Claude Desktop 配置

1. 打開 Claude Desktop 並訪問設置（從菜單，不在應用程序內）。
2. 點擊左側邊欄中的“開發者”，然後點擊“編輯配置”。
3. 將 Twitter MCP 服務器添加到您的配置中：

{
    "mcpServers": {
        "Twitter 助手": {
            "command": "npm",
            "args": [
                "--prefix",
                "/full/path/to/twitter-mcp-server.js",
                "start"
            ]
        }
    }
}

4. 將 /full/path/to/twitter-mcp-server.js 替換為實際服務器文件的路徑。
5. 保存配置文件並重新啟動 Claude Desktop。

使用示例

配置完成後，您可以向 Claude Desktop 提出以下問題：

• “Twitter 上當前有哪些熱門話題？”
• “起草一篇關於人工智能的專業推文”
• “創建一個包含 3 點的 Twitter 線程”
• “刪除我的最新推文”
• “分析這條推文的參與度潛力”

文件結構

twitter-mcp-server/
├── index.js          # 主應用程序文件
├── server.js        # HTTP 服務器邏輯
└── .env              # 環境變量配置文件

故障排除指南

• 問題：無法啟動服務器
  解決方法：檢查 Node.js 是否正確安裝，確認所有依賴項已安裝，並確保 .env 文件中的憑據正確。
• 問題：推文未發佈
  解決方法：檢查 API 密鑰是否有效，確認網絡連接正常，並查看控制檯的錯誤信息。

安全注意事項

• 確保 .env 文件安全，避免洩露敏感信息。
• 定期更新 API 憑據以維護賬戶安全。

📄 許可證

此項目受 MIT License 保護。