Twitter MCP サーバー

モデル コンテキスト プロトコル (MCP) 標準を活用した AI エージェント向けの強力な Twitter 統合で、クリーンかつ一貫性のあるインターフェースを通じて包括的な Twitter 機能セットを提供します。

概要

このサーバーは、MCPツールを介してTwitterの機能へのアクセスを提供し、AIアシスタントやその他のMCP対応クライアントとのシームレスな統合を可能にします。agent agent-twitter-clientライブラリをベースに構築されており、堅牢なエラー処理、レート制限、一貫したレスポンスフォーマットを提供します。

Related MCP server: MCP Twitter

特徴

基本的な読み方

• メディアサポートのあるユーザーからのツイートを取得する

• 詳細情報を含むユーザープロファイルを取得する

• ハッシュタグやキーワードでツイートを検索する

• 検索結果を最新/上位でフィルタリング

• レート制限（リクエストあたり最大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

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

エラー処理

サーバーは包括的なエラー処理を実装します。

• すべてのパラメータの入力検証

• レート制限保護

• 詳細なエラーメッセージ

• 適切なエラー伝播

• デバッグのためのログ記録

応答フォーマット

すべてのツールは一貫した形式で応答を返します。

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照