X Twitter MCP Server

🚀 X Twitter 管理控制面板 (MCP) 服務器文檔

X Twitter MCP 服務器是一款用於管理和控制 Twitter 平臺的工具，它提供了豐富功能，能幫助用戶自動化並優化 Twitter 使用體驗。本指南將詳細介紹該服務器的安裝、配置、使用方法，同時提供故障排除等實用信息。

🚀 快速開始

X Twitter MCP 服務器可助力你高效管理 Twitter 平臺。你可以按照以下步驟完成安裝和啟動，開啟使用之旅。

📦 安裝指南

安裝方式

方式一：從源代碼安裝

1. 克隆 GitHub 倉庫。
2. 打開終端，進入克隆後的文件夾。
3. 運行以下命令以安裝依賴項：

   pip install -r requirements.txt
   

4. 編輯 .env 文件並填充你的 Twitter API 憑證。

方式二：使用 PyPI 安裝

1. 在終端中運行以下命令：

   pip install x-twitter-mcp-server
   

2. 配置環境變量，參考 claude_desktop_config.json。

啟動服務器

1. 打開終端，導航到安裝目錄。
2. 運行啟動腳本：

   python -m x_twitter_mcp_server
   

💻 使用示例

基礎用法

X Twitter MCP 服務器提供了多種功能模塊，以下是部分功能的使用示例：

# 獲取用戶的主頁時間線
from x_twitter_mcp_server import get_timeline
timeline = get_timeline()
print(timeline)

# 點贊一條推文
from x_twitter_mcp_server import favorite_tweet
favorite_tweet(tweet_id)

高級用法

# 使用查詢詞搜索 Twitter，限制結果數量為 20
from x_twitter_mcp_server import search_twitter
search_results = search_twitter(query="example", limit=20)
print(search_results)

📚 詳細文檔

功能概述

X Twitter MCP 服務器提供了多種功能模塊，包括用戶管理、Tweet 操作、搜索與趨勢等。

用戶管理

• get_timeline: 獲取用戶的主頁時間線。
• get_latest_timeline: 獲取用戶關注的時間線。
• search_twitter: 根據查詢詞搜索 Twitter。
• get_trends: 獲取當前 Twitter 趨勢話題。

Tweet 操作

• favorite_tweet: 點贊一條推文。
• unfavorite_tweet: 取消點贊一條推文。
• bookmark_tweet: 將推文添加到書籤。
• delete_bookmark: 從書籤中刪除推文。
• delete_all_bookmarks: 刪除所有書籤。

搜索與趨勢

• search_twitter: 使用查詢詞搜索 Twitter，限制結果數量（默認為10）。
• get_trends: 獲取最多前10個當前流行的話題。

🔧 技術細節

故障排除

服務器無法啟動

1. 確保 .env 文件包含所有必要的 Twitter API 憑證（適用於從源代碼安裝的情況）。
2. 對於使用 PyPI 安裝的用戶，確認環境變量已在 claude_desktop_config.json 或 shell 中設置。
3. 在終端中查看啟動日誌以獲取錯誤信息。
4. 確保 uv 或 Python 可執行文件正確安裝且可訪問。

Claude 未檢測到服務器

1. 核查 claude_desktop_config.json 中的路徑是否正確。
2. 確認命令和參數指向正確的可執行文件和腳本。
3. 更新配置文件後重啟 Claude Desktop。
4. 啟用開發者模式，查看日誌文件以獲取更多錯誤信息。

速率限制錯誤

• 服務器已集成速率限制處理機制。如果遇到 Twitter API 的速率限制，請等待重置窗口時間（例如：tweet 操作為15分鐘）。

語法警告

• 如果出現 SyntaxWarning 提示，通常是由於代碼兼容性問題引起的，建議檢查並更新相關依賴項。

貢獻方式

歡迎貢獻！如果希望為項目做出貢獻，請參考 GitHub 倉庫 中的 CONTRIBUTING 文件。

📄 許可證

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