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 アプリから投稿を削除してください。

ツール

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

Related MCP server: pyX-MCP

エンドポイント

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

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

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

設定

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