X MCP Server

🚀 X MCP サーバー

X MCP サーバーは、Twitter と Claude デスクトップアプリケーションを統合するためのツールです。ツイートの取得、新しいツイートの投稿、ツイートの返信機能を提供し、レート制限処理機能も内蔵しています。

🚀 クイックスタート

X MCP サーバーを使用することで、Twitter と Claude デスクトップアプリケーションをシームレスに統合できます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• ツイートの取得、新しいツイートの投稿、ツイートの返信機能を提供します。
• Twitter の無料ティアに対するレート制限機能を内蔵しています。

📦 インストール

コードのダウンロード

1. このリポジトリをローカルにクローンします。
2. ターミナルを開き、プロジェクトディレクトリに移動します。

ビルド

以下のコマンドを実行して、TypeScript コードをビルドします。

npm run build

実行

• 開発モード（自動監視付き）：

  npm run dev
  

• 本番モード：

  npm start
  

📚 ドキュメント

設定

環境変数

claude_desktop_config.json ファイルに以下の設定を追加し、プレースホルダーを実際の API 認証情報に置き換えてください。

{
  "mcpServers": {
    "x": {
      "command": "node",
      "args": ["%USERPROFILE%/Projects/MCP Basket/x-server/build/index.js"],
      "env": {
        "TWITTER_API_KEY": "paste-your-api-key-here",
        "TWITTER_API_SECRET": "paste-your-api-key-secret-here",
        "TWITTER_ACCESS_TOKEN": "paste-your-access-token-here",
        "TWITTER_ACCESS_SECRET": "paste-your-access-token-secret-here"
      }
    }
  }
}

機能

ホームタイムラインのツイートを取得する

フォローしているユーザーが最新に投稿したツイートを取得します。

• パラメーター：
  • limit（オプション）：取得するツイートの数。デフォルトは20、最大値は100です。
• 例：

await use_mcp_tool({
  server_name: "x",
  tool_name: "get_home_timeline",
  arguments: { limit: 5 }
});

新しいツイートを投稿する

新しいツイートを投稿します。

• パラメーター：
  • text（必須）：ツイートの内容。最大280文字です。
• 例：

await use_mcp_tool({
  server_name: "x",
  tool_name: "create_tweet",
  arguments: { text: "Hello from MCP! 🤖" }
});

ツイートに返信する

指定されたツイートに返信します。

• パラメーター：
  • tweet_id（必須）：返信するツイートの ID。
  • text（必須）：返信の内容。最大280文字です。
• 例：

await use_mcp_tool({
  server_name: "x",
  tool_name: "reply_to_tweet",
  arguments: {
    tweet_id: "1234567890",
    text: "Great tweet! 👍"
  }
});

開発

ビルド

npm run build

開発モード

npm run dev

サーバーを実行する

npm start

レート制限処理

Twitter の無料ティアに対するレート制限機能が内蔵されています。

• 月次制限：
  • ユーザーレベル：月あたり最大500回の投稿操作。
  • アプリケーションレベル：月あたり最大500回の投稿操作。
  • 読み取り操作：月あたり最大100回。
• 機能：
  • 月次使用量を追跡します。
  • レート制限エラーを処理するための指数バックオフ機能を提供します。
  • 制限に達したときに明確なエラーメッセージを表示します。
  • レート制限ウィンドウが期限切れになるまで自動的に再試行します。

📄 ライセンス

MIT

🔧 技術詳細

貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add some amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを開きます。

注意事項

⚠️ 重要提示

API 認証情報を漏洩しないでください。

💡 使用建议

機密情報は暗号化して保存することをお勧めします。