Twitter MCP Server

by taazkareem
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supported as a platform for the MCP server, with specific configuration paths provided for macOS users.

  • Used for package management and running server scripts, facilitating installation and development workflows.

  • The server uses TypeScript for its response format, providing strongly typed structure for communication between the client and server.

Twitter MCP サーバー

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

概要

このサーバーは、MCPツールを介してTwitterの機能へのアクセスを提供し、AIアシスタントやその他のMCP対応クライアントとのシームレスな統合を可能にします。agent 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
  1. サーバーを構築します。
npm run build
  1. 環境変数を設定します。
# 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
  1. 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ファイルを参照

-
security - not tested
F
license - not found
-
quality - not tested

モデル コンテキスト プロトコル標準を通じて AI エージェントに包括的な Twitter 機能を提供し、ツイートの読み取り、コンテンツの投稿、インタラクションの管理、堅牢なエラー処理によるタイムライン データへのアクセスを可能にします。

  1. Overview
    1. Features
      1. Basic Reading
      2. User Interactions
      3. Advanced Features
      4. Media & Advanced Interactions
    2. Tools
      1. Reading Tools
      2. Interaction Tools
      3. Timeline Tools
      4. User Management Tools
    3. Installation
      1. Development
        1. Debugging
      2. Error Handling
        1. Response Format
          1. Contributing
            1. License
              ID: qep2xkblkw