X(Twitter) V2 MCP Server

X(Twitter) V2 MCP サーバー

Twitter/X API v2 と連携するためのツールを提供する MCP サーバーの実装です。このサービスでは、AI アシスタントがツイートの取得、新しい投稿、ツイートへの返信、ツイートの引用などをプログラムから実行できます。

ツール

X MCP Service は、Twitter/X API と連携するための次のツールを提供します。

get_tweets_by_userid

特定のユーザーのタイムラインからツイートを取得します。

• userId：ツイートを検索する Twitter ユーザー ID
• paginationToken（任意）：次のページの結果を取得するためのトークン
• exclude（任意）：除外するツイートの種類（リツイート、返信）
• maxResults（任意）：返すツイートの最大数（デフォルト：10）

get_tweet_by_id

ID を指定して単一のツイートを取得します。

• tweetId：取得するツイートの ID

get_user_mentions

特定のユーザーに言及しているツイートを取得します。

• userId：言及を取得する Twitter ユーザー ID
• paginationToken（任意）：次のページの結果を取得するためのトークン
• maxResults（任意）：返す言及の最大数（デフォルト：10）

quote_tweet

任意のテキストを添えてツイートを引用します。

• tweetId：引用するツイートの ID
• replyText：引用に添えるテキスト

reply_to_tweet

既存のツイートに返信します。

• tweetId：返信するツイートの ID
• replyText：返信のテキスト

post_tweet

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

• text：投稿する内容
• imageBase64：投稿する画像

like_tweet

特定のツイートに「いいね」します。

• tweetId：「いいね」するツイートの ID

follow_user

Twitter ユーザーをフォローします。

• targetUserId：フォローするユーザーの ID

unfollow_user

Twitter ユーザーのフォローを解除します。

• targetUserId：フォローを解除するユーザーの ID

get_user_by_username

ユーザー名を指定して Twitter ユーザーの情報を取得します。

• username：Twitter のユーザー名（@ 記号を除く）

search_tweets

クエリ文字列を使ってツイートを検索します。

• query：検索クエリ
• maxResults（任意）：返す結果の最大数（デフォルト：10）

get_trending_topics

特定の場所のトレンドトピックを取得します。

• woeid（任意）：場所を表す「Where On Earth ID」（WOEID）（世界全体の場合は 1、デフォルト：1）

create_list

新しい Twitter リストを作成します。

• name：リストの名前
• description（任意）：リストの説明（任意）
• isPrivate（任意）：リストを非公開にするかどうか（デフォルト：false）

add_list_member

Twitter リストにユーザーを追加します。

• listId：リストの ID
• userId：追加するユーザーの ID

remove_list_member

Twitter リストからユーザーを削除します。

• listId：リストの ID
• userId：削除するユーザーの ID

get_owned_lists

認証済みユーザーが所有するすべてのリストを取得します。

• パラメーターは不要です

設定

環境変数の設定

X API 認証

以下のトークンはすべて、X Developer Dashboard から取得できます。

TWITTER_API_KEY=your_api_key
TWITTER_API_KEY_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

開発

npm i

npm run build

npx @modelcontextprotocol/inspector node dist/index.js

http://127.0.0.1:6274 を開いて環境変数を設定し、ツールを操作してください。

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。MIT ライセンスの利用規約に従う限り、このソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリの LICENSE ファイルをご覧ください。