Skip to main content
Glama
Sign In
deenesjakoruzh
x-mcp

x-mcp

by RobertDWhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

x-mcp

X（Twitter）API v2 の前面に立つ MCP サーバー。イメージ: ghcr.io/robertdwhite/x-mcp。 マニフェストは whitehouse-rke2（apps/ai/x-mcp/）にあります。

読み取りは無料です。書き込みは2段階 — draft_post はプレビューと 使い捨ての confirm_token を返し、publish_post がその正確なトークンで呼び出されるまで何も公開されません。 エージェントは1回の呼び出しで投稿できないため、常に人間が見えるプレビューが先に存在します。 これは出力が公開かつ永続的である場合に重要です。

削除ツールは意図的にありません。削除は破壊的で取り消し不能です。X アプリから投稿を削除してください。

ツール

ツール

種類

備考

whoami

読み取り

認証情報がどのアカウントとして動作するか

get_tweet

読み取り

ID による1件の投稿

get_user_posts

読み取り

ハンドルからの最近の投稿

get_mentions

読み取り

認証済みアカウントへのメンション

get_home_timeline

読み取り

逆時系列のホームタイムライン

search_recent

読み取り

直近7日間の検索（プラン依存）

draft_post

ステージ

検証 + プレビュー。何も公開しない。

list_drafts

読み取り

ステージされた下書きと残り TTL

publish_post

書き込み

下書きを公開。公開かつ永続的。

下書きはインメモリです。再起動でクリアされるため、古い confirm token が プレビューを表示したプロセスより長生きすることはありません。

Related MCP server: x-mcp

エンドポイント

  • POST /mcp — ストリーミング可能な HTTP MCP。Authorization: Bearer $MCP_TOKEN で保護

  • GET /healthz — オープン。死活監視用

他のすべてのパスは 401 ではなく 404 を返します — MCP クライアントが起動時に行う /.well-known/oauth-* プローブも含みます。そこでの 401 はクライアントに インタラクティブな OAuth フローを試行させ、ヘッドレス クライアントは接続タイムアウトとしてハングします。

設定

環境変数

必須

目的

MCP_TOKEN

推奨

/mcp の Bearer。未設定 = 認証なし。

X_API_KEY

はい

コンシューマーキー

X_API_SECRET

はい

コンシューマーシークレット

X_ACCESS_TOKEN

はい

アクセストークン（ユーザーコンテキスト）

X_ACCESS_TOKEN_SECRET

はい

アクセストークンシークレット

X_MAX_CHARS

いいえ

文字数制限、デフォルト 280。プレミアムでは引き上げ。

X_DRAFT_TTL

いいえ

下書きの有効期限（秒）、デフォルト 600

X_TIMEOUT

いいえ

HTTP タイムアウト、デフォルト 30

X への認証は OAuth 1.0a ユーザーコンテキストで、リクエストごとに署名されます。 アプリ専用のベアラートークンは投稿できません。公開はアカウント として 行われるためです。 読み取りおよび書き込み権限を持つ X アプリから4つの値を取得してください。コンシューマーキーと、 自分のアカウント用に生成されたアクセストークン/シークレットのペアです。

認証情報がない場合、すべてのツールはスタックトレースの代わりに明確な「未設定」エラーを返します。 そのため、認証情報が存在する前にサービスをデプロイできます。

X API プランに関する注意

書き込みアクセスは X の有料 API ティアによって制限され、無料ティアは大幅に制限されています。 このサーバーからの 429 は、X が提供する場合にレート制限のリセットを表示します。 書き込みがすぐに失敗する場合は、developer.x.com でプランを確認してください。

ローカル実行

pip install -r requirements.txt
MCP_TOKEN=dev X_API_KEY=... X_API_SECRET=... \
  X_ACCESS_TOKEN=... X_ACCESS_TOKEN_SECRET=... python server.py

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • TwitGhost

    arvinmoj
    A
    license
    B
    quality
    D
    maintenance
    Enables interacting with Twitter/X through natural language, including searching tweets, posting, sending DMs, and managing timelines via any MCP client.
    8
    MIT

  • x-mcp

    namank42
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with the X (Twitter) API through MCP tools for managing users, posts, bookmarks, likes, and lists. Supports markdown or JSON output and uses OAuth 2.0 PKCE authentication.
    22
    -

  • x-mcp-server

    lluisfont
    F
    license
    B
    quality
    B
    maintenance
    MCP server for the official X API, enabling agents to read and publish posts, look up users, and search posts with safe read-only default and explicit write mode.
    8
    3 npm
    -

  • x-mcp-ai

    IvanBBaev
    A
    license
    A
    quality
    A
    maintenance
    Enables MCP clients to interact with the X (Twitter) API v2 through 41 typed tools for reading, searching, engaging, publishing, and managing content, with policy-based access control and session credit budgets to prevent overspending.
    41
    74 npm
    1
    MIT