Twitter MCP Server

🚀 Twitter MCP 服務器

這是一款功能強大的推特集成工具，專為 AI 代理量身打造。它藉助 Model Context Protocol (MCP) 標準，為推特功能提供全面支持，擁有簡潔且統一的接口，能極大提升使用效率。

🚀 快速開始

安裝步驟

1. 安裝依賴：

npm install

2. 構建服務器：

npm run build

3. 配置環境變量：

# 必填：推特賬號憑證（用於用戶認證）
TWITTER_USERNAME=你的用戶名
TWITTER_PASSWORD=你的密碼
TWITTER_EMAIL=你的郵箱

# 推特 API 認證（可選）
TWITTER_API_KEY=你的API密鑰
TWITTER_API_SECRET_KEY=你的API密鑰秘密
TWITTER_ACCESS_TOKEN=你的訪問令牌
TWITTER_ACCESS_TOKEN_SECRET=你的訪問令牌秘密

4. 配置文件示例：

# .env 文件示例配置
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

啟動服務器

npm run start

示例命令

# 獲取推文示例
curl -X GET http://localhost:3000/api/tweets

# 發佈推文示例
curl -X POST http://localhost:3000/api/tweets \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, Twitter!"}'

✨ 主要特性

基本閱讀

• 可獲取帶有媒體支持的用戶推文。
• 能獲取詳細的用戶資料信息。
• 支持根據 hashtag 或關鍵詞搜索推文。
• 可根據最新/熱門過濾搜索結果。
• 具備限流保護（每請求最多50條推文）。

用戶互動

• 可贊成/取消贊成推文。
• 能轉發/取消轉發推文。
• 支持發佈推文，涵蓋以下功能：
  • 文本內容發佈。
  • 媒體附件（圖片、視頻）添加。
  • 回覆功能。
  • 引用推文功能。

高級特性

• 可獲取用戶關係（關注者/關注列表）。
• 能獲取 trending topics。
• 支持訪問不同時間線類型：
  • 主動時間線。
  • 關注時間線。
  • 用戶時間線。
• 支持列表管理（獲取列表推文）。

媒體及高級互動

• 媒體處理：
  • 支持圖片上傳（JPEG, PNG, GIF）。
  • 支持視頻上傳（MP4）。
  • 具備 Alt 文本支持。
• 可創建線程。
• 能關注/取消關注用戶。

🛠️ 工具

閱讀工具

• get_tweets - 獲取用戶的最近推文。
• get_profile - 獲取用戶資料信息。
• search_tweets - 根據 hashtag 或關鍵詞搜索推文。

互動工具

• like_tweet - 贊成或取消贊成推文。
• retweet - 轉發或取消轉發。
• post_tweet - 發佈新推文，支持附件。
• create_thread - 創建 Twitter 線程。

時間線工具

• get_timeline - 獲取不同時間線類型推文。
• get_list_tweets - 獲取列表推文。
• get_trends - 獲取當前 trending topics。

用戶管理工具

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

📚 詳細文檔

錯誤處理

所有 API 請求都返回 JSON 格式的響應：

{
  "success": boolean,
  "error": string|null,
  "result": any
}

📄 許可證

項目遵循 MIT 許可證，具體內容請參考 LICENSE 文件。

🤝 貢獻指南

歡迎通過提交拉取請求為該項目做出貢獻。請閱讀 CONTRIBUTING.md 文件獲取更多信息。

感謝使用 Twitter MCP 服務器！如需幫助，請訪問我們的 GitHub 頁面 或聯繫支持郵箱：support@twittermcp.com。