Twitter MCP Server

Twitter MCP サーバー

Model Context Protocol（MCP）標準を活用した強力な Twitter 連携機能です。すっきりと一貫性のあるインターフェースを通じて、包括的な Twitter 機能を提供します。

概要

このサーバーは、MCP ツールを通じて Twitter の機能を利用できるようにし、AI アシスタントやその他の MCP 対応クライアントとシームレスに連携します。agent-twitter-client ライブラリを基盤として構築されており、堅牢なエラー処理、レート制限、一貫したレスポンス形式を提供します。

機能

基本的な読み取り

• メディアに対応したユーザーのツイート取得
• 詳細情報を含むユーザープロフィールの取得
• ハッシュタグまたはキーワードによるツイート検索
• 最新順／人気順による検索結果の絞り込み
• レート制限（1 リクエストあたり最大 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. 環境変数を設定します：

# Required: Twitter Account Credentials (for user authentication)
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password
TWITTER_EMAIL=your_email

# Twitter API Authentication (Optional)
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 サーバーは stdio 経由で通信するため、デバッグには MCP Inspector を使用できます：

npm run inspector

Inspector によって、ブラウザーでデバッグツールにアクセスするための URL が表示されます。

エラー処理

このサーバーは包括的なエラー処理を実装しています：

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

レスポンス形式

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

{
  content: [{
    type: "text",
    text: string // JSON stringified response or error message
  }]
}

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT License - 詳細については LICENSE ファイルをご覧ください