Skip to main content
Glama
Sign In
enesjakozh

X MCP Server

by DataWhisker
npmGitHub
JavaScript
MIT License
0
9
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • A Model Context Protocol (MCP) server for X (Twitter) integration that provides tools for reading your timeline and engaging with tweets. Allows users to get tweets from their home timeline, create new tweets, reply to tweets, and includes built-in rate limit handling for the free API tier.

X MCP サーバー

X（Twitter）統合用のモデルコンテキストプロトコル（MCP）サーバー。タイムラインの閲覧やツイートへのエンゲージメントのためのツールを提供します。Claudeデスクトップ向けに設計されています。

特徴

  • ホームタイムラインからツイートを取得する
  • 新しいツイートを作成する
  • ツイートに返信する
  • 無料 API 層向けの組み込みレート制限処理
  • 完全な型安全性を備えたTypeScript実装

前提条件

  • Node.js (v16 以上)
  • X（Twitter）開発者アカウント（無料）
  • クロードデスクトップアプリ

X APIアクセス

X (Twitter) は、基本的な API アクセスの無料レベルを提供します。

無料レベルの機能

  • 投稿制限:
    • ユーザーレベルで月500件の投稿
    • アプリレベルで月500件の投稿
  • 読み取り制限:
    • 毎月100回読む
  • 特徴：
    • v2 投稿エンドポイントへのアクセス
    • メディアアップロードエンドポイント
    • 広告APIへのアクセス
    • アプリIDは1つまで
    • X機能でログイン
  • レート制限:
    • すべてのエンドポイントへのレート制限されたアクセス
    • 制限は定期的にリセットされます

注: より多くのボリュームが必要な場合は、有料プランをご利用いただけます。

  • ベーシック層（月額100ドル）：50,000ツイート/月、追加エンドポイント
  • プロレベル（月額5000ドル）：より高い制限とエンタープライズ機能

無料レベルにアクセスするには、https: //developer.x.com/en/portal/products/freeにアクセスしてください。

インストール

  1. リポジトリをクローンします。
git clone [your-repo-url] cd x-mcp-server
  1. 依存関係をインストールします:
npm install
  1. サーバーを構築します。
npm run build

構成

X（Twitter）APIの認証情報を設定する必要があります。以下の手順に従ってください。

  1. Twitter開発者ポータルへアクセス
    • X（Twitter）アカウントでサインイン
    • 開発者アカウントをお持ちでない場合は、作成するように求められます。
  2. 無料レベルにアクセスする:
  3. 新しいプロジェクトを作成します。
    • 「プロジェクトを作成」ボタンをクリックします
    • プロジェクト名を入力します（例：「MCP統合」）
    • セットアップとして「無料」を選択してください
    • ユースケースを選択してください
    • 「次へ」をクリック
  4. プロジェクト内に新しいアプリを作成します。
    • 「アプリを作成」をクリックします
    • アプリ名を入力してください
    • 「セットアップを完了」をクリックします
  5. アプリ設定を構成します。
    • アプリダッシュボードで「アプリ設定」をクリックします
    • 「ユーザー認証設定」の下:
      • 「設定」をクリック
      • OAuth 1.0aを有効にする
      • 「Webアプリ」または「ネイティブアプリ」を選択します
      • コールバック用の任意の URL を入力します (例: https://example.com/callback )
      • ウェブサイトの URL を入力します (例: https://example.com )
      • 「保存」をクリック
  6. アプリの権限を設定します:
    • アプリ設定で「アプリの権限」を見つけます
    • 「読み書き」に変更
    • 「保存」をクリック
  7. API キーとトークンを生成します:
    • 「キーとトークン」タブに移動します
    • 「コンシューマー キー」の下:
      • 「キーの表示」または「再生成」をクリックします
      • APIキーとAPIキーシークレットを保存する
    • 「アクセス トークンとシークレット」の下:
      • 「生成」をクリック
      • 「読み取りと書き込み」権限を持つトークンを選択してください
      • アクセストークンとアクセストークンシークレットを保存します

重要：

  • 鍵とトークンを安全に保管し、公開しないでください
  • 次の 4 つの値すべてが必要になります。
    • API キー（コンシューマー キーとも呼ばれます）
    • API キー シークレット (コンシューマー シークレットとも呼ばれます)
    • アクセストークン
    • アクセストークンシークレット
  • 無料利用枠の制限に注意してください:
    • ユーザーレベルで月500件の投稿
    • アプリレベルで月500件の投稿
    • 毎月100回読む

クロードデスクトップ構成

X MCPサーバーをClaudeデスクトップに接続するには、Claudeの設定で設定する必要があります。以下の手順に従ってください。

  1. ファイルエクスプローラーを開く
  2. Claude config ディレクトリに移動します。
    • Win + Rキーを押す
    • %APPDATA%/Claudeと入力してEnterキーを押します。
    • Claudeフォルダが存在しない場合は作成します
  3. claude_desktop_config.jsonを作成または編集します。
    • ファイルが存在しない場合は、 claude_desktop_config.jsonという名前の新しいファイルを作成します。
    • 存在する場合は、テキストエディタ（メモ帳など）で開きます。
  4. 次の構成を追加し、プレースホルダー値を前のセクションの実際の API 認証情報に置き換えます。
{ "mcpServers": { "x": { "command": "node", "args": ["%USERPROFILE%/Projects/MCP Basket/x-server/build/index.js"], "env": { "TWITTER_API_KEY": "paste-your-api-key-here", "TWITTER_API_SECRET": "paste-your-api-key-secret-here", "TWITTER_ACCESS_TOKEN": "paste-your-access-token-here", "TWITTER_ACCESS_SECRET": "paste-your-access-token-secret-here" } } } }
  1. ファイルを保存し、Claudeデスクトップを再起動します。

注意: 必ず次の点に注意してください:

  • 4つの認証情報の値すべてを実際のAPIキーとトークンに置き換えます
  • 各値を引用符（""）で囲みます
  • 上記の間隔と書式を正確に維持してください
  • .json拡張子でファイルを保存します。

利用可能なツール

ゲットホームタイムライン

ホームタイムラインから最新のツイートを取得します。

パラメータ:

  • limit (オプション): 取得するツイートの数 (デフォルト: 20、最大: 100)

例：

await use_mcp_tool({ server_name: "x", tool_name: "get_home_timeline", arguments: { limit: 5 } });

ツイートを作成

新しいツイートを作成します。

パラメータ:

  • text （必須）: ツイートのテキストコンテンツ（最大280文字）

例：

await use_mcp_tool({ server_name: "x", tool_name: "create_tweet", arguments: { text: "Hello from MCP! 🤖" } });

ツイートに返信

ツイートに返信します。

パラメータ:

  • tweet_id (必須): 返信するツイートのID
  • text （必須）: 返信のテキストコンテンツ（最大280文字）

例：

await use_mcp_tool({ server_name: "x", tool_name: "reply_to_tweet", arguments: { tweet_id: "1234567890", text: "Great tweet! 👍" } });

発達

  • npm run build : TypeScriptコードをビルドする
  • npm run dev : TypeScriptをウォッチモードで実行する
  • npm start : MCPサーバーを起動する

レート制限

サーバーには、X の無料レベルに対するレート制限処理機能が組み込まれています。

  • 月間制限:
    • ユーザーレベルで月500件の投稿
    • アプリレベルで月500件の投稿
    • 毎月100回読む
  • 特徴：
    • 月間使用量を追跡
    • レート制限エラーに対して指数バックオフを提供する
    • 制限に達したときにエラーメッセージをクリアする
    • レート制限ウィンドウの有効期限が切れた後の自動再試行

ライセンス

マサチューセッツ工科大学

貢献

  1. リポジトリをフォークする
  2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
  3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
  4. ブランチにプッシュする ( git push origin feature/amazing-feature )
  5. プルリクエストを開く

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

Server for X（Twitter）統合により、タイムラインの閲覧やツイートへのエンゲージメントのためのツールが提供されます。Claudeデスクトップ版での使用向けに設計されています。

  1. Features
    1. Prerequisites
      1. X API Access
        1. Free Tier Features
      2. Installation
        1. Configuration
          1. Claude Desktop Configuration
            1. Available Tools
              1. get_home_timeline
              2. create_tweet
              3. reply_to_tweet
            2. Development
              1. Rate Limiting
                1. License
                  1. Contributing

                    Appeared in Searches

                    ID: 5nx3qqiunw