6551Team/opentwitter-mcp

opentwitter-mcp – AI 助手的 Twitter 資料伺服器

什麼是它 – 一個基於 FastMCP 的小型 HTTP/WebSocket 伺服器，將 Twitter/X 資料（個人檔案、推文、搜尋、追蹤者事件、KOL 追蹤等）封裝在簡單的 API 後方。它旨在於本地端執行，然後作為 MCP (Model-Context-Protocol) 伺服器新增至 AI 驅動的程式碼助手，例如 Claude, OpenClaw, Cursor, Zed 等，以便助手可以針對 Twitter 進行自然語言提問並獲得結構化結果。

關鍵能力

能力	如何公開
使用者個人檔案查詢	get_twitter_user / get_twitter_user_by_id
使用者的近期推文	get_twitter_user_tweets
關鍵字 / Hashtag 搜尋	search_twitter, search_twitter_advanced
即時追蹤者 / 取消追蹤者事件	get_twitter_follower_events (WebSocket push)
已刪除推文偵測	get_twitter_deleted_tweets
KOL 追蹤者發現	get_twitter_kol_followers
觀察名單管理 (新增 / 刪除 / 列出)	add_twitter_watch, delete_twitter_watch, get_twitter_watch
完整推文獲取 (包含回覆、引用、媒體)	get_twitter_tweet_by_id, get_twitter_quote_tweets_by_id, get_twitter_retweet_users_by_id

安裝與啟動

1. 取得 Token – 在 http://app.newsliquid.com/mcp 註冊並複製 OPENNEWS_TOKEN。
2. 設定 Token – 可以作為環境變數或放在專案根目錄的 config.json 中：

   export OPENNEWS_TOKEN="<your-token>"   # macOS / Linux
   # Windows PowerShell
   $env:OPENNEWS_TOKEN = "<your-token>"
   

3. 執行伺服器 – README 建議使用 uv 建置工具 (一個現代化的 Python-only 替代方案，用於 Poetry/venv)：

   uv --directory /path/to/twitter-mcp run twitter-mcp
   

   相同的指令可以嵌入到任何支援的 AI 客戶端 (Claude Code, OpenClaw, Cursor, 等) 的 MCP 配置中。

AI 助手如何與之溝通

• 助手會將伺服器註冊為名為 twitter 的 MCP。
• 當你輸入自然語言請求 (例如：“顯示 @elonmusk 的 Twitter 個人檔案” )，助手會呼叫對應的工具 (例如：get_twitter_user)。
• 結果會以 README 中定義的 JSON 結構返回 (使用者物件、推文物件、事件陣列等)。
• 對於即時監控，助手可以開啟 WebSocket wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN 並接收 JSON-RPC push 事件，例如 NEW_TWEET, NEW_FOLLOWER, DELETE, 等。

配置選項

變數	用途
OPENNEWS_TOKEN (必填)	6551 後端 API 的 Bearer token
TWITTER_API_BASE	覆蓋預設的 REST 端點 (預設為 https://ai.6551.io)
TWITTER_MAX_ROWS	每次請求返回的最大項目數 (預設 100)

環境變數與 config.json 檔案皆支援；若兩者皆存在，環境變數優先。

支援的客戶端 – README 列出了 Claude Code (claude mcp add twitter …) 和 OpenClaw (複製 skill directory) 的現成指令。它也為許多編輯器 (Cursor, Zed, Continue.dev, 等) 提供了 JSON/YAML 片段，以便伺服器可以從編輯器的 MCP 整合功能自動啟動。

開發

• 程式碼位於 src/twitter_mcp/ 下，具有清晰的佈局：server.py (進入點), app.py (FastMCP app), config.py, api_client.py, 和 tools.py (八個公開工具)。
• 依賴項極小：mcp 框架, httpx 用於 HTTP 呼叫, 以及 uv 用於環境管理。
• 若要參與開發：使用 uv sync 安裝，然後 uv run twitter-mcp。

授權 – MIT, 因此你可以自由地修改或將其嵌入到你自己的 AI 助手設定中。

---

總結 – opentwitter-mcp 是一個輕量級、專為用途而生的橋樑，讓 AI 程式碼助手可以查詢實時 Twitter 資料並接收事件流，而不需要助手本身實踐實時 Twitter API。這是一個真正的軟體專案，旨在於 AI 增強型工作流中使用，而非僅僅是一個教學或連結列表。