X MCP サーバー

X（Twitter）統合用のモデルコンテキストプロトコル（MCP）サーバー。タイムラインの閲覧やツイートへのエンゲージメントのためのツールを提供します。Claudeデスクトップ向けに設計されています。

特徴

• ホームタイムラインからツイートを取得する

• 新しいツイートを作成する

• ツイートに返信する

• 無料 API 層向けの組み込みレート制限処理

• 完全な型安全性を備えたTypeScript実装

前提条件

• Node.js (v16 以上)

• X（Twitter）開発者アカウント（無料）

• クロードデスクトップアプリ

X APIアクセス

X (Twitter) は、基本的な API アクセスの無料レベルを提供します。

無料レベルの機能

• 投稿制限:

  • ユーザーレベルで月500件の投稿

  • アプリレベルで月500件の投稿

• 読み取り制限:

  • 毎月100回読む

• 特徴：

  • v2 投稿エンドポイントへのアクセス

  • メディアアップロードエンドポイント

  • 広告APIへのアクセス

  • アプリIDは1つまで

  • X機能でログイン

• レート制限:

  • すべてのエンドポイントへのレート制限されたアクセス

  • 制限は定期的にリセットされます

注: より多くのボリュームが必要な場合は、有料プランをご利用いただけます。

• ベーシック層（月額100ドル）：50,000ツイート/月、追加エンドポイント

• プロレベル（月額5000ドル）：より高い制限とエンタープライズ機能

無料レベルにアクセスするには、https: //developer.x.com/en/portal/products/freeにアクセスしてください。

インストール

1. リポジトリをクローンします。

2. 依存関係をインストールします:

3. サーバーを構築します。

構成

X（Twitter）APIの認証情報を設定する必要があります。以下の手順に従ってください。

1. Twitter開発者ポータルへアクセス

   • X（Twitter）アカウントでサインイン

   • 開発者アカウントをお持ちでない場合は、作成するように求められます。

2. 無料レベルにアクセスする:

   • https://developer.x.com/en/portal/products/freeにアクセスしてください

   • 無料アクセス層については「購読」をクリックしてください

   • 登録手続きを完了する

3. 新しいプロジェクトを作成します。

   • 「プロジェクトを作成」ボタンをクリックします

   • プロジェクト名を入力します（例：「MCP統合」）

   • セットアップとして「無料」を選択してください

   • ユースケースを選択してください

   • 「次へ」をクリック

4. プロジェクト内に新しいアプリを作成します。

   • 「アプリを作成」をクリックします

   • アプリ名を入力してください

   • 「セットアップを完了」をクリックします

5. アプリ設定を構成します。

   • アプリダッシュボードで「アプリ設定」をクリックします

   • 「ユーザー認証設定」の下:

     • 「設定」をクリック

     • OAuth 1.0aを有効にする

     • 「Webアプリ」または「ネイティブアプリ」を選択します

     • コールバック用の任意の URL を入力します (例: https://example.com/callback )

     • ウェブサイトの URL を入力します (例: https://example.com )

     • 「保存」をクリック

6. アプリの権限を設定します:

   • アプリ設定で「アプリの権限」を見つけます

   • 「読み書き」に変更

   • 「保存」をクリック

7. API キーとトークンを生成します:

   • 「キーとトークン」タブに移動します

   • 「コンシューマー キー」の下:

     • 「キーの表示」または「再生成」をクリックします

     • APIキーとAPIキーシークレットを保存する

   • 「アクセス トークンとシークレット」の下:

     • 「生成」をクリック

     • 「読み取りと書き込み」権限を持つトークンを選択してください

     • アクセストークンとアクセストークンシークレットを保存します

重要：

• 鍵とトークンを安全に保管し、公開しないでください

• 次の 4 つの値すべてが必要になります。

  • API キー（コンシューマー キーとも呼ばれます）

  • API キー シークレット (コンシューマー シークレットとも呼ばれます)

  • アクセストークン

  • アクセストークンシークレット

• 無料利用枠の制限に注意してください:

  • ユーザーレベルで月500件の投稿

  • アプリレベルで月500件の投稿

  • 毎月100回読む

クロードデスクトップ構成

X MCPサーバーをClaudeデスクトップに接続するには、Claudeの設定で設定する必要があります。以下の手順に従ってください。

1. ファイルエクスプローラーを開く

2. Claude config ディレクトリに移動します。

   • Win + Rキーを押す

   • %APPDATA%/Claudeと入力してEnterキーを押します。

   • Claudeフォルダが存在しない場合は作成します

3. claude_desktop_config.jsonを作成または編集します。

   • ファイルが存在しない場合は、 claude_desktop_config.jsonという名前の新しいファイルを作成します。

   • 存在する場合は、テキストエディタ（メモ帳など）で開きます。

4. 次の構成を追加し、プレースホルダー値を前のセクションの実際の API 認証情報に置き換えます。

5. ファイルを保存し、Claudeデスクトップを再起動します。

注意: 必ず次の点に注意してください:

• 4つの認証情報の値すべてを実際のAPIキーとトークンに置き換えます

• 各値を引用符（""）で囲みます

• 上記の間隔と書式を正確に維持してください

• .json拡張子でファイルを保存します。

利用可能なツール

ゲットホームタイムライン

ホームタイムラインから最新のツイートを取得します。

パラメータ:

• limit (オプション): 取得するツイートの数 (デフォルト: 20、最大: 100)

例：

ツイートを作成

新しいツイートを作成します。

パラメータ:

• text （必須）: ツイートのテキストコンテンツ（最大280文字）

例：

ツイートに返信

ツイートに返信します。

パラメータ:

• tweet_id (必須): 返信するツイートのID

• text （必須）: 返信のテキストコンテンツ（最大280文字）

例：

発達

• npm run build : TypeScriptコードをビルドする

• npm run dev : TypeScriptをウォッチモードで実行する

• npm start : MCPサーバーを起動する

レート制限

サーバーには、X の無料レベルに対するレート制限処理機能が組み込まれています。

• 月間制限:

  • ユーザーレベルで月500件の投稿

  • アプリレベルで月500件の投稿

  • 毎月100回読む

• 特徴：

  • 月間使用量を追跡

  • レート制限エラーに対して指数バックオフを提供する

  • 制限に達したときにエラーメッセージをクリアする

  • レート制限ウィンドウの有効期限が切れた後の自動再試行

ライセンス

マサチューセッツ工科大学

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く