fxtwitter-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
fxtwitter-mcp
FxTwitter / FxEmbed API を Model Context Protocol(MCP)から利用する、Cloudflare Workers + Hono製のリモートMCPサーバーです。
FxTwitter API v2の読み取り系GET APIを16個のMCPツールとして公開します。MCPエンドポイントはステートレスなStreamable HTTPで、認証はありません。
このプロジェクトはFxTwitter / FxEmbedの非公式クライアントです。公開デプロイすると、URLを知っている第三者も上流APIを呼び出せます。必要に応じてCloudflare Accessや独自認証を追加してください。
構成
Cloudflare Workers
Hono
Cloudflare Agents SDK
createMcpHandlerMCP TypeScript SDK v2
TypeScript
Vitest + Cloudflare Workers runtime
Related MCP server: TwitGhost
エンドポイント
パス | メソッド | 用途 |
| GET | サービス情報 |
| GET | ヘルスチェック |
| GET / POST / DELETE | MCP Streamable HTTP |
MCPツール
すべて読み取り専用・非破壊・冪等なツールです。
ツール | FxTwitter API |
| 投稿を取得 |
| 投稿をリポストしたユーザーを取得 |
| 引用投稿を取得 |
| スレッドを展開して取得 |
| スレッドと返信を取得 |
| ユーザーの投稿を取得 |
| ユーザーの記事を取得 |
| About Account統計を取得 |
| ユーザーのメディア投稿を取得 |
| フォロワーを取得 |
| フォロー中ユーザーを取得 |
| プロフィールを取得 |
| 投稿を検索 |
| ユーザーを検索 |
| 検索候補を取得 |
| トレンドを取得 |
カーソルが返るAPIは自動で全ページを取得しません。レスポンスの cursor.bottom を次の呼び出しの cursor に指定してください。
ローカル実行
Node.js 20以降が必要です。PowerShellでプロジェクトのルートから実行します。
npm install
npm run dev起動後のMCP URLは http://localhost:8787/mcp です。
MCP Inspectorで接続確認する場合:
npx @modelcontextprotocol/inspector@latestInspectorでTransportにStreamable HTTP、URLに http://localhost:8787/mcp を指定します。
検証
npm test
npm run typecheck
npm run types:check
npm run deploy:dry-runすべてを順番に実行する場合:
npm run checkテストではURLエンコード、タイムアウト、JSON不正、5 MiB上限、APIエラー、全16ツールのルーティング、MCPツール一覧、Origin検証をCloudflare Workersランタイム上で確認します。外部API通信はモックされます。
制限と安全対策
上流は
https://api.fxtwitter.comに固定しています。FxTwitterが要求する識別用User-Agentを送信します。
パス要素とクエリはURL APIでエンコードし、任意URLへのアクセスは受け付けません。
上流リクエストは10秒でタイムアウトします。
上流レスポンスは5 MiBまで読み込みます。
FxTwitter APIのレート制限や利用条件に従ってください。
検索結果などはMCPへ整形せず、上流JSONをそのまま返します。
ライセンス
MIT License © 2026 Tomoya Ogawa
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Official twitterapi.io hosted MCP: Twitter/X tweets, users, followers, trends. OAuth or API key.
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
Live X/Twitter data: profiles, tweets, search, followers, lists and trends. 29 read-only tools.
Official MCP server for twitterapis.com. Twitter/X search, users, DMs, Grok, monitoring and writes.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to access Twitter/X data including user profiles, tweets, search, and follower events via a set of MCP tools.MIT
- AlicenseBqualityDmaintenanceEnables interacting with Twitter/X through natural language, including searching tweets, posting, sending DMs, and managing timelines via any MCP client.8MIT
- AlicenseAqualityBmaintenanceMCP server to read X (Twitter) posts, threads, replies, quotes, and search using your own logged-in session, no API key required.8206 PyPI4MIT
- AlicenseAqualityBmaintenanceEnables 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.4148 npm1MIT