Twitter MCP Server

🚀 Twitter MCP 服務器

這是一個強大的用於 AI 代理的 Twitter 集成服務，它利用模型上下文協議（MCP）標準，通過簡潔一致的接口提供了一套全面的 Twitter 功能。

🚀 快速開始

本服務器通過 MCP 工具提供對 Twitter 功能的訪問，可與 AI 助手和其他兼容 MCP 的客戶端實現無縫集成。它基於 agent-twitter-client 庫構建，具備強大的錯誤處理、速率限制和統一的響應格式。

✨ 主要特性

基礎閱讀功能

• 獲取帶有媒體支持的用戶推文
• 獲取包含詳細信息的用戶資料
• 按主題標籤或關鍵詞搜索推文
• 按最新/熱門過濾搜索結果
• 速率限制（每次請求最多 50 條推文）

用戶交互功能

• 點贊/取消點贊推文
• 轉發/取消轉發推文
• 發佈推文，支持：
  • 文本內容
  • 媒體附件（圖片、視頻）
  • 回覆功能
  • 引用推文功能

高級功能

• 獲取用戶關係（關注者/關注列表）
• 獲取熱門話題
• 訪問不同類型的時間線：
  • 主頁時間線
  • 關注時間線
  • 用戶時間線
• 列表管理（獲取列表推文）

媒體與高級交互功能

• 媒體處理：
  • 圖片上傳（JPEG、PNG、GIF）
  • 視頻上傳（MP4）
  • 支持替代文本
• 創建推文線程
• 關注/取消關注用戶

📦 安裝指南

1. 安裝依賴：

npm install

2. 構建服務器：

npm run build

3. 配置環境變量：

# 必需：Twitter 賬戶憑證（用於用戶認證）
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter API 認證（可選）
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

4. 將服務器配置添加到您的 MCP 客戶端：

在 MacOS 上：

~/Library/Application Support/Claude/claude_desktop_config.json

在 Windows 上：

%APPDATA%/Claude/claude_desktop_config.json

配置內容：

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "/path/to/twitter-mcp-server/build/index.js"
    }
  }
}

💻 使用示例

基礎用法

{
  content: [{
    type: "text",
    text: string // JSON 字符串化的響應或錯誤消息
  }]
}

高級用法

// 高級場景說明：所有工具都以這種一致的格式返回響應，方便處理和解析。
{
  content: [{
    type: "text",
    text: string // JSON 字符串化的響應或錯誤消息
  }]
}

閱讀工具

• get_tweets - 獲取用戶的近期推文
• get_profile - 獲取用戶的資料信息
• search_tweets - 按主題標籤或關鍵詞搜索推文

交互工具

• like_tweet - 點贊或取消點贊推文
• retweet - 轉發或取消轉發推文
• post_tweet - 發佈帶有可選媒體的新推文
• create_thread - 創建 Twitter 推文線程

時間線工具

• get_timeline - 獲取不同類型時間線的推文
• get_list_tweets - 獲取 Twitter 列表中的推文
• get_trends - 獲取當前熱門話題

用戶管理工具

• get_user_relationships - 獲取關注者或關注列表
• follow_user - 關注或取消關注用戶

🔧 技術細節

開發

若要進行開發並實現自動重建，可使用以下命令：

npm run watch

調試

由於 MCP 服務器通過標準輸入輸出進行通信，您可以使用 MCP 檢查器進行調試：

npm run inspector

檢查器將提供一個 URL，您可以在瀏覽器中訪問調試工具。

錯誤處理

服務器實現了全面的錯誤處理：

• 對所有參數進行輸入驗證
• 速率限制保護
• 詳細的錯誤消息
• 正確的錯誤傳播
• 用於調試的日誌記錄

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🤝 貢獻

歡迎貢獻代碼！請隨意提交拉取請求。