Reqable Mcp Server

Reqable MCP サーバー

Reqable MCP Server は、ローカルの Reqable キャプチャートラフィックを MCP クライアント（Windsurf/Cursor/Claude/Codex）に公開します。

デフォルトのアーキテクチャはローカルのみで動作します。

1. Reqable が HAR（JSON）を http://127.0.0.1:18765/report に送信します。
2. オプションの増分 WebSocket イベントは http://127.0.0.1:18765/ws/events に送信できます。
3. reqable-mcp がリクエスト／メッセージを正規化し、ローカルの SQLite に保存します。
4. MCP ツールはローカルデータのみを照会します（デフォルトではクラウドリレーを使用しません）。

ドキュメント：英語 | 日本語

機能

• ローカル優先、プライバシー優先の取り込み経路。
• Reqable Report Server によるリアルタイム取り込み。
• 取得できなかったセッション用の HAR ファイルインポートによる補完。
• HTTP リクエストの照会／検索／ドメイン統計／API 分析。
• メッセージフレーム拡張を含む HAR エントリーの WebSocket セッション／メッセージ解析。
• クロスプラットフォームのランタイム（macOS / Linux / Windows、Python 3.10 以降）。

前提条件

1. Reqable をインストールして開きます。
2. Reqable Report Server が http://127.0.0.1:18765/report に送信するよう設定します。
3. Node.js（npx 用）と uv（uvx 用）が利用できることを確認します。

インストール

npx 経由で実行（推奨）

npx -y reqable-mcp@latest

ローカル開発

uv run reqable-mcp

MCP クライアントの設定

{
  "mcpServers": {
    "reqable": {
      "command": "npx",
      "args": ["-y", "reqable-mcp@latest"]
    }
  }
}

Reqable Report Server の設定

Reqable の「Add Report Server」で、次の値を使用します。

1. 名前：reqable-mcp-local
2. マッチルール：*（または対象のドメイン）
3. サーバー URL：http://127.0.0.1:18765/report
4. 圧縮：None（または受信側の設定に合わせます）

保存後にトラフィックを生成し、ingest_status を呼び出して受信ペイロード数を確認します。

重要な注意：reqable-mcp は引き続き HTTP のみの取り込みトランスポートを使用します（ネイティブの ws:// リスナーはありません）が、現在は 2 つの HTTP 取り込み経路に対応しています。HAR／セッションペイロード用の /report と、増分 WebSocket イベント用の /ws/events です。Reqable のペイロードにフレームデータ（例：_webSocketMessages またはイベントフレームオブジェクト）が含まれている場合、WebSocket キャプチャーが機能します。生のエントリー JSON と生のメッセージ JSON は保持され、WebSocket ツールから利用できます。ライブ送信でフレームを取得できなかった場合は、HAR のエクスポート／インポートを引き続き代替手段として利用できます。

利用可能なツール

• ingest_status：取り込みサーバーの状態とカウンター
• import_har：ファイルパスから HAR をインポート
• list_requests：フィルターを指定して、最近の HTTP／WebSocket ハンドシェイクリクエストを一覧表示
• get_request：ID でリクエストの詳細を取得（full には raw_entry が含まれます）
• search_requests：HTTP URL／本文／アップロードされた生のエントリー（raw／raw_entry）をキーワード検索
• list_websocket_sessions：キャプチャーした WebSocket セッションを一覧表示
• list_active_websocket_sessions：最後にキャプチャーしたフレームを基に、最近アクティブだった WebSocket セッションを一覧表示
• get_websocket_session：ID で WebSocket セッションの詳細とメッセージを取得（raw_entry とメッセージの raw を含む）
• tail_websocket_messages：request_id と after_seq カーソルを使用してメッセージを増分取得
• search_websocket_messages：キーワード、方向、タイプ、オペコード、クローズコード、ドメイン、リクエスト ID で WebSocket メッセージを詳細検索
• analyze_websocket_session：セッションの方向、メッセージタイプ、JSON 形式、クローズイベントを要約
• export_websocket_session_raw：アップロードされた生の WebSocket エントリーと生のフレーム一覧をエクスポート
• health_report：取り込みステータスと WebSocket データ品質レポート
• repair_websocket_messages：生のフレームから不足しているフィールドを補完（ドライランに対応）
• get_domains：ドメイン単位のリクエスト統計
• analyze_api：ドメインの API 形式を推測
• generate_code：キャプチャーした HTTP リクエストからサンプルクライアントコードを生成

環境変数

変数	説明	デフォルト
REQABLE_INGEST_HOST	レポート受信ホスト	127.0.0.1
REQABLE_INGEST_PORT	レポート受信ポート	18765
REQABLE_INGEST_PATH	レポート受信パス	/report
REQABLE_WS_EVENTS_PATH	増分 WebSocket イベント受信パス	/ws/events
REQABLE_DATA_DIR	ローカルデータディレクトリ	プラットフォームのアプリデータディレクトリ
REQABLE_DB_PATH	SQLite ファイルパス	${REQABLE_DATA_DIR}/requests.db
REQABLE_MAX_BODY_SIZE	リクエスト／メッセージごとに保存する本文の最大バイト数	102400
REQABLE_MAX_REPORT_SIZE	受け入れるレポートペイロードの最大バイト数	10485760
REQABLE_MAX_IMPORT_FILE_SIZE	HAR インポートファイルの最大バイト数	104857600
REQABLE_RETENTION_DAYS	ローカルデータの保持期間	7
REQABLE_INGEST_TOKEN	任意のローカル認証トークン	未設定

プライバシーとデータ保持

• デフォルトモードでは、データはローカルマシンに保存されます。
• WebSocket メッセージを含むローカル DB レコードに対して、保持期間に基づくクリーンアップが適用されます。
• 取り込みサーバーがオフラインの場合、Reqable は失敗したレポートの送信を再試行しません。

ライセンス

MIT