Twitter MCP Server

🚀 Twitter MCP Server

Twitter MCP Serverは、Model Context Protocol (MCP) 標準を活用したAIエージェント向けの強力なTwitter統合サーバーです。このサーバーは、クリーンで一貫性のあるインターフェースを通じて、包括的なTwitter機能を提供します。

🚀 クイックスタート

このサーバーは、MCPツールを通じてTwitterの機能にアクセスできるようにし、AIアシスタントやその他のMCP互換クライアントとのシームレスな統合を可能にします。agent-twitter-clientライブラリをベースに構築されており、堅牢なエラーハンドリング、レート制限、一貫したレスポンス形式を提供します。

✨ 主な機能

基本的な閲覧機能

• メディア付きのユーザーのツイートを取得
• 詳細情報を含むユーザープロファイルを取得
• ハッシュタグまたはキーワードでツイートを検索
• 最新/トップで検索結果をフィルタリング
• レート制限（リクエストごとに最大50ツイート）

ユーザーインタラクション

• ツイートをいいね/いいね解除
• ツイートをリツイート/リツイート解除
• 以下の内容でツイートを投稿：
  • テキストコンテンツ
  • メディア添付（画像、動画）
  • 返信機能
  • 引用ツイート機能

高度な機能

• ユーザーの関係（フォロワー/フォロー中）を取得
• トレンドトピックを取得
• 以下の異なるタイムラインタイプにアクセス：
  • ホームタイムライン
  • フォロー中タイムライン
  • ユーザータイムライン
• リスト管理（リストのツイートを取得）

メディアと高度なインタラクション

• メディア処理：
  • 画像アップロード（JPEG、PNG、GIF）
  • 動画アップロード（MP4）
  • 代替テキストサポート
• スレッド作成
• ユーザーをフォロー/フォロー解除

🛠️ ツール

閲覧ツール

• get_tweets - ユーザーの最近のツイートを取得
• get_profile - ユーザーのプロファイル情報を取得
• search_tweets - ハッシュタグまたはキーワードでツイートを検索

インタラクションツール

• like_tweet - ツイートをいいね/いいね解除
• retweet - ツイートをリツイート/リツイート解除
• post_tweet - オプションのメディア付きで新しいツイートを投稿
• create_thread - Twitterスレッドを作成

タイムラインツール

• get_timeline - 異なるタイムラインタイプからツイートを取得
• get_list_tweets - Twitterリストからツイートを取得
• get_trends - 現在のトレンドトピックを取得

ユーザー管理ツール

• get_user_relationships - フォロワーまたはフォロー中のリストを取得
• follow_user - ユーザーをフォロー/フォロー解除

📦 インストール

1. 依存関係をインストールします：

npm install

2. サーバーをビルドします：

npm run build

3. 環境変数を設定します：

# 必須：Twitterアカウントの資格情報（ユーザー認証用）
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter API認証（オプション）
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

4. MCPクライアントにサーバー設定を追加します：

MacOSの場合：

~/Library/Application Support/Claude/claude_desktop_config.json

Windowsの場合：

%APPDATA%/Claude/claude_desktop_config.json

設定内容：

{
  "mcpServers": {
    "twitter-mcp-server": {
      "command": "/path/to/twitter-mcp-server/build/index.js"
    }
  }
}

💻 開発

自動再ビルドを使用した開発の場合は、以下のコマンドを実行します：

npm run watch

デバッグ

MCPサーバーは標準入出力を介して通信するため、MCPインスペクターを使用してデバッグできます：

npm run inspector

インスペクターは、ブラウザでデバッグツールにアクセスするためのURLを提供します。

🔧 エラーハンドリング

サーバーは包括的なエラーハンドリングを実装しています：

• すべてのパラメータの入力検証
• レート制限保護
• 詳細なエラーメッセージ
• 適切なエラー伝播
• デバッグ用のログ記録

📄 レスポンス形式

すべてのツールは、一貫した形式でレスポンスを返します：

{
  content: [{
    type: "text",
    text: string // JSON文字列化されたレスポンスまたはエラーメッセージ
  }]
}

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルを参照してください。