X.com MCP Server

🚀 X.com MCP Server

X.com MCP Serverは、X.comのAPI機能へのアクセスを提供するモデルコンテキストプロトコルサーバーです。このサーバーは、OAuth 2.0認証を通じて大規模言語モデル（LLMs）が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 - すべての投稿を検索します（完全なアーカイブ - 学術/企業アクセスが必要）。

投稿数

• getPostCountsRecent - 最近の投稿の時間区分ごとの投稿数を取得します。
• getPostCountsAll - すべての投稿の時間区分ごとの投稿数を取得します（学術/企業）。

リツイート

• 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開発者アカウントを作成します。
2. 新しいプロジェクトとアプリを作成します。
3. OAuth 2.0資格情報を生成します。
4. PKCEフローを使用したOAuth 2.0認可コードを実装します。
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. "Can you search for recent posts about artificial intelligence?"
2. "Create a post about the benefits of TypeScript."
3. "Find posts that mention machine learning and show their engagement metrics."
4. "Get my recent bookmarks and analyze the topics."

ビルド

# 依存関係をインストールする
pnpm install

# TypeScriptをビルドする
pnpm run build

# サーバーを起動する
pnpm start

レート制限

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

• ほとんどの読み取り操作: 15分間に300リクエスト
• 書き込み操作: 15分間に50リクエスト
• ブックマーク操作: 15分間に50回の書き込み / 180回の読み取り

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