X Twitter MCP Server

🚀 X Twitter 管理コントロールパネル (MCP) サーバードキュメント

X Twitter MCP サーバーは、Twitter プラットフォームを管理および制御するためのツールです。豊富な機能を提供し、ユーザーが Twitter の使用体験を自動化および最適化するのに役立ちます。このガイドでは、サーバーのインストール、設定、使用方法を詳細に説明し、トラブルシューティングやその他の有用な情報も提供します。

🚀 クイックスタート

このセクションでは、X Twitter MCP サーバーのインストール、起動、および基本的な使用方法を説明します。

✨ 主な機能

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: ソースコードからインストール

1. GitHub リポジトリ をクローンします。
2. ターミナルを開き、クローンしたフォルダに移動します。
3. 以下のコマンドを実行して依存関係をインストールします。

pip install -r requirements.txt

4. .env ファイルを編集し、Twitter API の認証情報を入力します。

方法2: PyPI を使用してインストール

1. ターミナルで以下のコマンドを実行します。

pip install x-twitter-mcp-server

2. claude_desktop_config.json を参考に環境変数を設定します。

サーバーの起動

1. ターミナルを開き、インストールディレクトリに移動します。
2. 起動スクリプトを実行します。

python -m x_twitter_mcp_server

💻 使用例

基本的な使用法

# ユーザーのホームタイムラインを取得する例
from x_twitter_mcp_server import get_timeline

timeline = get_timeline()
print(timeline)

📚 ドキュメント

トラブルシューティング

サーバーが起動しない場合

1. ソースコードからインストールした場合は、.env ファイルにすべての必要な Twitter API 認証情報が含まれていることを確認します。
2. PyPI を使用してインストールしたユーザーは、claude_desktop_config.json またはシェルで環境変数が設定されていることを確認します。
3. ターミナルで起動ログを確認してエラー情報を取得します。
4. uv または Python 実行ファイルが正しくインストールされ、アクセス可能であることを確認します。

Claude がサーバーを検出しない場合

1. claude_desktop_config.json のパスが正しいことを確認します。
2. コマンドとパラメータが正しい実行ファイルとスクリプトを指していることを確認します。
3. 設定ファイルを更新した後、Claude Desktop を再起動します。
4. 開発者モードを有効にし、ログファイルを確認して詳細なエラー情報を取得します。

レート制限エラー

• サーバーにはレート制限処理機構が組み込まれています。Twitter API のレート制限に遭遇した場合は、リセットウィンドウ時間（例：ツイート操作では15分）を待ってください。

構文警告

• SyntaxWarning が表示された場合は、通常はコードの互換性問題によるものです。関連する依存関係を確認して更新することをお勧めします。

貢献方法

GitHub リポジトリ の CONTRIBUTING ファイルを参照して、プロジェクトに貢献することができます。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細は LICENSE ファイルを参照してください。