6551Team/opentwitter-mcp

opentwitter-mcp – AI アシスタントのための Twitter データサーバー

概要 – FastMCP ベースの小型 HTTP/WebSocket サーバーで、Twitter/X のデータ (プロフィール, ツイート, 検索, フォロワーイベント, KOL 追跡, 等) をシンプルな API でラップしています。 これは、ローカルで実行し、その後 Claude, OpenClaw, Cursor, Zed, 等の AI 駆動型コーディングアシスタントに MCP (Model-Context-Protocol) サーバーとして追加することで、アシスタントが Twitter に関する自然言語の質問を投げ、構造化された結果を得られるようにすることを目的としています。

主な機能

機能	公開方法
ユーザープロフィール検索	get_user_twitter_user / get_user_twitter_user_by_id
ユーザーの最近のツイート	get_twitter_user_tweets
キーワード / ハッシュタグ検索	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. トークンを取得 – http://app.newsliquid.com/mcp に登録し、OPENNEWS_TOKEN をコピーします。
2. トークンを設定 – 環境変数として、またはプロジェクトのルートに置く config.json に設定します：

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

3. サーバーを起動 – README は uv ビルドツール (Poetry/venv の現代的な Python-only 替代方案) を推奨しています：

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

   同じコマンドを MCP 構成設定として、サポートされている AI クライアント (Claude Code, OpenClaw, Cursor, etc.) に埋め込むことができます。

AI アシスタントとの通信方法

• アシスタントはサーバーを twitter という名前の MCP として登録します。
• 当、あなたは自然言語の要求 (e.g., “@elonmusk の Twitter プロフィールを表示して” )、アシスタントは適切なツールを呼び出します (e.g., get_twitter_user)。
• 結果は README に定義された JSON 構造で返されます (ユーザーオブジェクト, ツイートオブジェクト, イベント配列, 等)。
• リアルタイム監視のため、アシスタントは WebSocket wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN を開き、NEW_TWEET, NEW_FOLLOWER, DELETE, 等の JSON-RPC push イベントを受信します。

設定オプション

変数	用途
OPENNEWS_TOKE (必填)	6551 バックエンド API の Bearer token
TWITTER_API_BASE	デフォルトの REST エンドポイントを上書き (デフォルトは https://ai.6551.io)
TWITTER_MAX_ROWS	1 リクエストあたりの最大項目数 (デフォルト 100)

環境変数と config.json ファイルの両方がサポートされています。環境変数があれば、環境変数 wins します。

サポートされているクライアント – README には Claude Code (claude mcp add twitter …) や OpenClaw (skill directory をコピー) のための準備された one-liner コマンドがあります。 また、多くのエディタ (Cursor, Zed, Continue.dev, etc.) 用の JSON/YAML スニペットを提供しています。 これにより、サーバーを自動的に起動できます。

開発

• コードは src/twitter_mcp/ にあり、レイアウトは明確です： server.py (エントリポイント), app.py (FastMCP app), config.py, api_client.py, tools.py (8 つの公開ツール)。
• 依存関係は最小限です： mcp フレームワーク, httpx 用の HTTP 呼び出し, uv 用の環境管理。
• プロジェクトを開発する場合： uv sync でインストールし、 uv run twitter-mcp で実行します。

License – MIT, なので、自由に MODIFY したり、ご自身の AI-assistant 設定的 に 組み込むことができます。

---

結論 – opentwitter-mcp は、アシスタントが Twitter API を自ら実装する必要なしに、AI コーディングアシスタントがライブ Twitter データをクエリし、イベントストリームを受信するための軽量で目的特化型のブリッジです。 これは、単なるチュートリアルやリンク集ではなく、AI-augmented workflow を目指した本物のソフトウェアプロジェクトです。