JW3 MCP Server

JW3 MCP + CLI

公式 MCP Registry に io.github.agnostic4321-ops/jw3-mcp-cli （リモート、Streamable HTTP）として登録されています。検出（initialize、tools/list）は公開されていますが、 すべてのツール呼び出しで OAuth サインインまたはスコープ付き PAT が必要です。

スタンドアロンのハーネスリポジトリです。MCP ツールサーバー（Supabase エッジ関数）と、 JSON-RPC サーフェスを利用する jw3 コマンドラインの薄いラッパーを含みます。

アプリとハーネスのライフサイクルを分離するため、jw3_ai から切り出しました（2026-10-26）。 デプロイ済みの関数 URL に変更はありません。同じ Supabase プロジェクト、同じスラッグです。

構成

• cli/ — @jw3/cli（jw3 / jw3d バイナリ）。mcp-server サーフェスを利用する純粋な HTTP クライアントで、アプリのインポートはありません。pnpm --filter @jw3/cli build/test。
• edge-functions/ — 同じプロジェクトにデプロイされる Supabase エッジ関数：
  • mcp-server（ゲートウェイ JWT は無効 — ハーネスの PAT がゲートです）
  • mcp-auth、mcp-token、mcp-oauth（トークン発行 / OAuth）

関数のデプロイ

# Syncs edge-functions/{_shared,agent-chat} from the ../jw3_ai checkout
# (override with JW3_AI_DIR), runs deno check, then stages the standard
# supabase/functions layout in a temp dir and deploys.
scripts/sync-edge-shared.sh --deploy mcp-server

このルートから supabase functions deploy を直接実行しても動作しません。ソースは edge-functions/ の下にあり（supabase/functions/ ではありません）、../_shared + ../agent-chat のインポートは、上記の同期手順を実行した後でのみ解決されます（以前は一時的なシンボリックリンクを作成する手順でしたが、現在はこのコミット済みスクリプトを使用します。コピーは gitignore 対象で、コミットされません）。同期のみ（デプロイなし）の場合は、引数を指定せずにスクリプトを実行してください。

supabase/config.toml ではゲートウェイフラグが固定されています（認証情報が JWT ではなくハーネス PAT の場合は、verify_jwt = false）。

パリティ契約

jw3_ai/src/test/read-tool-parity.test.ts は、兄弟パス ../jw3-mcp-cli/edge-functions/mcp-server/* にこのリポジトリが存在する場合に読み込み、存在しない場合はスキップします。 read_live_datum の種類と共有リーダー（fetchOnchainSnapshot、 executeScreenerRead、インラインの buildOnchainAggregate は使用しない）を jw3_ai の agent-chat/read-tools.ts と同期させてください。テストによってローカルで検証されます。