X.com MCP Server

X.com MCP サーバー

X.com の API 機能を利用できる Model Context Protocol サーバーです。このサーバーを使用すると、LLM は OAuth 2.0 認証を通じて X.com（旧 Twitter）を操作できます。投稿、いいね、リポスト、ブックマークの読み取り、作成、検索、管理など、投稿に関連する主要な操作に対応しています。

機能

• OAuth 2.0 認証 - 安全なベアラートークン認証
• 投稿 API を完全にカバー - 公式 API の X.com 投稿エンドポイントすべてに対応
• 型安全性 - Zod による検証を備えた TypeScript の完全実装
• 包括的なツール - X.com の主要な操作を網羅する 21 個のツール

利用可能なツール

検索

• getSinglePost - オプションのフィールド拡張を指定して、ID で単一の投稿を取得します
• getBulkPosts - ID を指定して最大 100 件の投稿を取得します

投稿の管理

• createPost - テキスト、メディア、アンケート、返信などを含む新しい投稿を作成します
• deletePost - ID で投稿を削除します
• hideReply - 投稿への返信を非表示または再表示します

タイムライン

• getUserTimeline - ユーザーの投稿タイムラインを取得します
• getUserMentions - 特定のユーザーへのメンションを含む投稿を取得します

検索

• searchRecent - 最近の投稿（過去 7 日間）を検索します
• searchAll - すべての投稿（全アーカイブ）を検索します（Academic／Enterprise アクセスが必要です）

投稿数

• getPostCountsRecent - 最近の投稿数を時間単位で集計して取得します
• getPostCountsAll - すべての投稿数を時間単位で集計して取得します（Academic／Enterprise）

リポスト

• getRetweets - 特定の投稿をリポストした投稿を取得します
• createRetweet - 投稿をリポストします
• deleteRetweet - リポストを取り消します

いいね

• getLikingUsers - 特定の投稿にいいねしたユーザーを取得します
• getLikedTweets - ユーザーがいいねした投稿を取得します
• likePost - 投稿にいいねします
• unlikePost - 投稿のいいねを取り消します

ブックマーク

• getUserBookmarks - ユーザーのブックマーク済み投稿を取得します
• bookmarkPost - 投稿をブックマークします
• removeBookmark - ブックマークを削除します

インストール

pnpm を使用する場合（推奨）

pnpm install
pnpm run build

インストール後、次のコマンドで実行できます。

node dist/index.js

Docker を使用する場合

docker build -t x.com-mcp .
docker run -i --rm -e X_COM_ACCESS_TOKEN=your-access-token x.com-mcp

設定

環境変数

• X_COM_ACCESS_TOKEN（必須）：X.com OAuth 2.0 アクセストークン

認証の設定

1. developer.x.com で X.com Developer Account を作成します
2. 新しいプロジェクトとアプリを作成します
3. OAuth 2.0 の認証情報を生成します
4. OAuth 2.0 Authorization Code with PKCE フローを実装します
5. 取得したアクセストークンを X_COM_ACCESS_TOKEN として保存します

Claude.app の設定

Claude の設定に追加します。

"mcpServers": {
  "x-com": {
    "command": "node",
    "args": ["dist/index.js"],
    "env": {
      "X_COM_ACCESS_TOKEN": "your-access-token"
    }
  }
}

"mcpServers": {
  "x-com": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "-e", "X_COM_ACCESS_TOKEN=your-access-token", "x.com-mcp"]
  }
}

やり取りの例

1. 投稿を作成します：

{
  "name": "createPost",
  "arguments": {
    "text": "Hello world! This is my first post via the MCP server.",
    "reply_settings": "everyone"
  }
}

2. 最近の投稿を検索します：

{
  "name": "searchRecent",
  "arguments": {
    "query": "artificial intelligence",
    "max_results": 10,
    "tweet.fields": "created_at,author_id,public_metrics"
  }
}

3. ユーザーのタイムラインを取得します：

{
  "name": "getUserTimeline",
  "arguments": {
    "id": "123456789",
    "max_results": 20,
    "expansions": "author_id"
  }
}

4. 投稿にいいねします：

{
  "name": "likePost",
  "arguments": {
    "user_id": "123456789",
    "tweet_id": "987654321"
  }
}

5. 投稿数を取得します：

{
  "name": "getPostCountsRecent",
  "arguments": {
    "query": "machine learning",
    "granularity": "day"
  }
}

対応する API エンドポイント

このサーバーは、X.com API v2 仕様の投稿関連エンドポイントすべてを実装しています。

• 検索：/2/tweets/:id、/2/tweets
• 投稿の管理：/2/tweets (POST)、/2/tweets/:id (DELETE)、/2/tweets/:id/hidden (PUT)
• タイムライン：/2/users/:id/tweets、/2/users/:id/mentions
• 検索：/2/tweets/search/recent、/2/tweets/search/all
• 投稿数：/2/tweets/counts/recent、/2/tweets/counts/all
• リポスト：/2/tweets/:id/retweets、/2/users/:id/retweets
• いいね：/2/tweets/:id/liking_users、/2/users/:id/liked_tweets、/2/users/:id/likes
• ブックマーク：/2/users/:id/bookmarks

必要なスコープ

X.com アプリに次の OAuth 2.0 スコープが設定されていることを確認してください。

• tweet.read - 投稿とユーザー情報を読み取ります
• tweet.write - 投稿を作成および削除します
• tweet.moderate.write - 返信を非表示または再表示します
• users.read - ユーザー情報を読み取ります
• like.read - いいね情報を読み取ります
• like.write - 投稿にいいねし、いいねを取り消します
• bookmark.read - ブックマークを読み取ります
• bookmark.write - ブックマークを作成および削除します

デバッグ

MCP インスペクターを使ってサーバーをデバッグできます。

npx @modelcontextprotocol/inspector node dist/index.js

Claude への質問例

1. 「人工知能に関する最近の投稿を検索してもらえますか？」
2. 「TypeScript のメリットについて投稿を作成してください。」
3. 「機械学習に言及している投稿を見つけて、エンゲージメント指標を表示してください。」
4. 「最近のブックマークを取得して、トピックを分析してください。」

ビルド

# Install dependencies
pnpm install

# Build TypeScript
pnpm run build

# Start server
pnpm start

レート制限

X.com API のレート制限にご注意ください。

• ほとんどの読み取り操作：15 分あたり 300 リクエスト
• 書き込み操作：15 分あたり 50 リクエスト
• ブックマーク操作：15 分あたり、書き込み 50 回／読み取り 180 回

詳細なレート制限情報については、X.com API documentation を参照してください。