X MCP Server

🚀 X MCP 服務器

X MCP 服務器是一款用於集成 Twitter 和 Claude 桌面應用的工具。它具備獲取推文、發佈新推文以及回覆推文等功能，同時還內置了速率限制處理功能，能有效保障使用的穩定性和合規性。

🚀 快速開始

X MCP 服務器的使用非常便捷，你可以按照以下步驟快速搭建並運行：

1. 克隆此倉庫到本地。
2. 打開終端，進入項目目錄。
3. 運行 npm run build 構建 TypeScript 代碼。
4. 選擇開發模式（帶自動監聽）運行 npm run dev，或者選擇生產模式運行 npm start。

📦 安裝指南

下載代碼

1. 克隆此倉庫到本地。
2. 打開終端，進入項目目錄。

構建

運行以下命令構建 TypeScript 代碼：

npm run build

運行

• 開發模式（帶自動監聽）：

  npm run dev
  

• 生產模式：

  npm start
  

✨ 主要特性

功能豐富

• 獲取主頁推文：可獲取你關注的用戶最新發布的推文，還能通過 limit 參數指定獲取數量。
• 發佈新推文：支持發佈最多 280 個字符的新推文。
• 回覆推文：能針對指定的推文進行回覆，回覆內容同樣最多 280 個字符。

速率限制處理

內置了針對 Twitter 免費 tier 的速率限制功能：

• 每月限制：
  • 用戶級：每月最多 500 次發佈操作。
  • 應用級：每月最多 500 次發佈操作。
  • 讀取操作：每月最多 100 次。
• 特性：
  • 跟蹤每月使用量。
  • 提供指數回退功能以處理速率限制錯誤。
  • 達到限制時會給出清晰的錯誤消息。
  • 自動重試直到速率限制窗口過期。

💻 使用示例

基礎用法

獲取主頁推文

await use_mcp_tool({
  server_name: "x",
  tool_name: "get_home_timeline",
  arguments: { limit: 5 }
});

發佈新推文

await use_mcp_tool({
  server_name: "x",
  tool_name: "create_tweet",
  arguments: { text: "Hello from MCP! 🤖" }
});

回覆推文

await use_mcp_tool({
  server_name: "x",
  tool_name: "reply_to_tweet",
  arguments: {
    tweet_id: "1234567890",
    text: "Great tweet! 👍"
  }
});

📚 詳細文檔

配置

環境變量

在 claude_desktop_config.json 文件中添加以下配置，替換佔位符為你的實際 API 憑據：

{
  "mcpServers": {
    "x": {
      "command": "node",
      "args": ["%USERPROFILE%/Projects/MCP Basket/x-server/build/index.js"],
      "env": {
        "TWITTER_API_KEY": "paste-your-api-key-here",
        "TWITTER_API_SECRET": "paste-your-api-key-secret-here",
        "TWITTER_ACCESS_TOKEN": "paste-your-access-token-here",
        "TWITTER_ACCESS_SECRET": "paste-your-access-token-secret-here"
      }
    }
  }
}

開發

構建

npm run build

開發模式

npm run dev

運行服務器

npm start

貢獻指南

1. 叉倉庫。
2. 創建你的功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m 'Add some amazing feature'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打開 Pull Request。

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

請勿洩露你的 API 憑據。

💡 使用建議

建議將敏感信息加密存儲。