TwitterTools MCP

twittertools-mcp

Model Context Protocol サーバーです。 TwitterTools のツールキットを AI エージェント （Claude、ChatGPT、Cursor、ZCode、…）で利用できるようにします。ログイン不要、トラッキングなし、API キー不要です。 公式 MCP Registry には io.github.steley/twittertools-mcp として登録されています。

ツール

ツール	機能
get_tweet	URL または ID を指定して公開投稿を取得します。本文、投稿者、直接 CDN URL 付きのメディアを取得できます
get_thread	スレッドを順番に投稿へ展開します（部分的な結果にはフラグが付きます）
count_chars	X の実際の 280 文字制限に照らしてテキストを計測します（CJK は 2 文字、リンクは 23 文字としてカウント）
split_thread	長いテキストを、番号付きで文字数制限に収まる投稿に分割します
parse_tweet_url	URL／ID から ID、投稿者のハンドル、投稿時刻、正規のパーマリンクを取得します

get_tweet／get_thread は、ステートレスな twittertools.com API を呼び出します。この API は X の無料シンジケーションエンドポイントを通じて公開投稿を解決します。他の 3 つはすべてオフラインで動作します。メディアはプロキシされません。ツイートの結果には pbs.twimg.com／video.twimg.com の直接 URL が含まれ、各クライアントが独自に取得できます。

このパッケージには依存関係が一切ありません。MCP プロトコル層は手作業で実装されているため（標準入力／標準出力上の行区切り JSON-RPC）、サプライチェーンに関わるコードはこのディレクトリ内の数百行だけです。Socket や任意のスキャナーで検証できます。

インストール

# Claude Code
claude mcp add twittertools -- npx -y twittertools-mcp

または、mcpServers 設定を読み込む任意のクライアントに追加します （Claude Desktop の claude_desktop_config.json、Cursor の .cursor/mcp.json、…）：

{
  "mcpServers": {
    "twittertools": {
      "command": "npx",
      "args": ["-y", "twittertools-mcp"]
    }
  }
}

Node 18 以降が必要です。

ヒント：npx は起動のたびにレジストリから最新バージョンを解決します （キャッシュ後はすぐに起動し、初回のみ数秒かかります）。起動時の遅延をなくすには、 npm i -g twittertools-mcp を一度実行し、"command": "twittertools-mcp" を設定します。

セルフホスト

TWITTERTOOLS_API_BASE を独自の server/downloader_server.py インスタンスに設定すると、検索をすべて自分の インフラストラクチャ内で完結できます：

{ "command": "npx", "args": ["-y", "twittertools-mcp"], "env": { "TWITTERTOOLS_API_BASE": "https://your-instance.example" } }

プライバシー

このサーバーはステートレスです。データは保存されず、テレメトリーもアカウントもありません。設定された API ベースとのみ通信します。API 自体は IP ごとにレート制限され、匿名の集計カウンターのみを保持します。詳細は twittertools.com/privacy をご覧ください。

開発

npm install
cd .. && npx vitest run mcp   # unit + stdio protocol tests (offline, mock API)

MIT ライセンスです。メインプロジェクトと同じです。