DAG Studio WebMCP

DAG Studio WebMCP

OpenAI 2026 WebMCP Challenge に向けた、人間と AI が協働する因果 DAG ワークスペースです。

AI が提案し、研究者が判断し、エンジンが検証します。

HTTPS ライブサンドボックス · オリジナルの DAG Studio · Apache 2.0 ライセンス

問題点

因果有向非巡回グラフは、どの変数がどの変数の原因となるのか、何が測定されるのか、あるいは潜在変数なのか、どの経路が効果推定にバイアスをもたらす可能性があるのかといった、科学的な仮定を表します。こうした判断には、専門分野の知識と科学的な説明責任が必要です。汎用エージェントは、研究者によるグラフの確認や編集を支援できますが、視覚的なブラウザー自動化は遅く、曖昧で、アプリケーションの因果的な意味論から切り離されています。

DAG Studio WebMCP は、既存の DAG Studio インターフェースを共有ワークスペースに変えます。研究者はキャンバスを直接編集しながら、エージェントはブラウザー標準の構造化ツールを使って、まったく同じグラフを読み取り、更新できます。エージェントによる変更はすべて表示され、取り消し可能です。因果エンジンはグラフの含意を確認しますが、エンジンもエージェントも、科学的真実を決定するとは主張しません。

WebMCP が重要な理由

WebMCP がない場合、エージェントはピクセルや DOM 構造からノードの識別、エッジの向き、分析コントロールを推測しなければなりません。WebMCP を使うと、DAG Studio は add_node、add_edge、analyze_current_dag など、安全性を考慮して専用に設計された操作を明示的に公開します。

これにより、これまでは困難だった双方向の協働が可能になります。

1. エージェントは、インターフェースをスクレイピングせずに、ライブグラフを読み取れます。
2. エージェントは、変更内容とその提案者を明確にした、正確な変更案を提示できます。
3. 研究者は、変更をすぐに確認し、移動、編集、承認、取り消しできます。
4. 人間がキャンバス上で編集した内容は、すぐにエージェントから見えるようになります。
5. 既存の因果エンジンが、バックドア経路と調整による含意を検証します。
6. エージェントは、競合する DAG 仮説に基づいて再現可能なデータをシミュレーションし、構造上および統計上の含意を比較できます。

ライブデモ

サンドボックスを、ChatGPT の WebMCP 対応ブラウザー、または chrome://flags/#enable-webmcp-testing を有効にした Chrome で開いてください。ツールが利用可能になると、ヘッダーに WebMCP 接続済み と表示されます。

プロンプトの例：

現在の DAG を読み取ってください。交絡因子の候補として Smoking Status を提案し、Treatment と Outcome に矢印が向くように追加してから、グラフを分析してください。追加内容は私が確認するための仮定として扱い、ほかの変更は行わないでください。

グラフはその場で更新されます。新しいノードを手動で移動してから、もう一度グラフを読み取るようエージェントに依頼すると、両者が同じ状態を共有していることを確認できます。

WebMCP ツール

ツール	動作
get_current_dag	ライブノード、役割、位置、有向エッジ、曝露、アウトカムを読み取ります。
add_node	研究者が確認できる変数を、表示中のキャンバスに追加します。
remove_node	ノードと、そのノードに接続するエッジを削除します。
add_edge	有向の因果関係を追加します。重複エッジ、自己ループ、循環エッジは拒否されます。
remove_edge	有向の因果関係を削除します。
analyze_current_dag	開いたバックドア経路、最小十分調整集合、識別可能性、診断結果を返します。
check_adjustment_set	提案された集合を、エンコードされたバックドア経路に照らして確認します。
generate_analysis_code	ライブグラフ用の R/dagitty または Python/NetworkX コードを生成します。
simulate_current_dag	ライブグラフに対して既存の線形ガウス SEM を実行し、シミュレーション結果を画面に表示して、上限付きの要約、相関、効果推定値、10 行のプレビューを返します。

この統合では、現在の document.modelContext API を優先し、以前の WebMCP ドラフトを実装しているホスト向けに、一時的な navigator.modelContext フォールバックも含まれています。

アーキテクチャ

Researcher edits canvas ─┐
                        ├─ React state + synchronous refs ─ DAG Studio engine
Agent calls WebMCP tools ┘                    │
                                             ├─ paths and adjustment sets
                                             ├─ diagnostics
                                             ├─ R/Python generation
                                             └─ reproducible simulation summaries

• index.html には、既存の React DAG Studio インターフェースが含まれています。
• webmcp-tools.js は、キャンバスの状態参照、変更ラッパー、既存のシミュレーションエンジンへの依存性注入を通じて、9 つのツールを定義し、登録します。
• dag-engine.js と dag-engine.d.ts は、既存の DAG Studio の因果エンジンと型宣言です。Challenge の作業ではこのエンジンを呼び出しますが、因果アルゴリズムを書き換えることはありません。
• グラフ、分析、元に戻す履歴、WebMCP の操作は、引き続きクライアント側で実行されます。
• 静的ビルドは Cloudflare Pages で HTTPS 経由でホストされています。

人による制御と安全性

因果構造はソフトウェアが発見した事実ではなく、主張です。そのため、ツールの説明と応答では、変更を研究者による確認が必要な提案として示します。エージェントによる変更は次のように扱われます。

• 人が編集するのと同じキャンバスに表示されます。
• エージェントによる変更通知が表示されます。
• 人による変更と同じ元に戻す履歴に追加されます。
• グラフの循環と無効なノード参照は拒否されます。
• 結果はエンコードされた仮定に依存するという注意書きを明示的に返します。

例とインターフェース全体

継承された DAG Studio インターフェースには、交絡、媒介、コライダーバイアス、M バイアスの標準的な構造に加え、次の機能が含まれています。

• ドラッグ＆ドロップによる DAG 編集と型付き変数
• 曝露とアウトカムの指定
• 因果経路とバックドア経路の強調表示
• 最小調整に関するガイダンスと構造的役割の診断
• R および Python のコード生成と、コードからキャンバスへのワークフロー
• クライアント側でのデータシミュレーション
• 画像、PDF、PowerPoint、コードのエクスポート

2026 年 8 月 25 日より前に存在していたもの

Challenge 参加前のベースラインは、2026 年 7 月 8 日付のコミット 31cc431612ba18a8bce1ab0841a88a0bb8b815f3 における、公開アプリケーション Black-Swan-Causal-Labs/dag-studio です。この時点で、ビジュアル DAG エディター、因果推論エンジン、教育用の例、分析パネル、コードコンソール、シミュレーション、エクスポート、レスポンシブ UI がすでに含まれていました。

元のアプリケーションには、WebMCP ツールの公開、エージェントによるグラフ編集の帰属表示、人とエージェントが 1 つのグラフ状態を共有してアクセスするテストはありませんでした。

WebMCP Challenge 向けに特別に構築したもの

次の作業は、2026 年 8 月 25 日以降の Challenge 提出期間中に追加されました。

• DAG の再現可能なライブシミュレーションを含む、9 つの WebMCP ツール
• それらのツールとキャンバスの既存の共有状態との直接的な接続
• WebMCP 接続の診断と、現行 API および旧 API との互換性
• エージェントによる変更の可視化と、元に戻すことができる帰属表示
• ツール登録、エージェントによる変更、人からエージェントへの状態共有、エッジ／ノードの削除、循環の拒否、エンジン分析、調整の確認、コード生成、シミュレーションの再現性、結果の上限設定、入力検証を対象とする自動テスト
• 本番の DAG Studio を変更しない独立した HTTPS サンドボックス
• Challenge 専用のドキュメントとデモ手順

ローカルで実行する

git clone https://github.com/Black-Swan-Causal-Labs/dag-studio-webmcp.git
cd dag-studio-webmcp
npm install
npm run dev

表示された Vite の URL を開きます。Chrome でネイティブ WebMCP を有効にするには、chrome://flags/#enable-webmcp-testing を有効にして Chrome を再起動します。

テストとビルド

npm test
npm run build

テストコマンドでは、元の DAG エンジンとの同等性テストスイートと、WebMCP／共有状態テストスイートの両方が実行されます。本番ビルドは、あらゆる HTTPS 静的ホストで利用できる静的な dist/ ディレクトリです。

科学的根拠

因果エンジンは、Pearl（2009）、Greenland、Pearl & Robins（1999）、Textor et al.（2016）に基づく d-分離と調整のロジックを実装しています。効果修飾の分類は、VanderWeele & Robins（2007）および Weinberg（2007）に従っています。詳細については、アプリ内の「About」と「Education」のセクションを参照してください。

作成者とライセンス

John D. Diaz-Decaro, PhD, MS · Black Swan Causal Labs

Apache License 2.0 © 2026 John D. Diaz-Decaro, Black Swan Causal Labs, LLC. 詳細はLICENSEをご覧ください。

再利用されている dag-engine.js と dag-engine.d.ts は DAG Studio に由来し、dagstudio-mcp と共有されています。 3 つのプロジェクトはいずれも Apache License 2.0 のもとでエンジンを配布しています。WebMCP Challenge の作業では、エンジンを呼び出しており、その因果アルゴリズムを書き換えてはいません。

リモート MCP クライアント

オプションのリモート MCP ブリッジを使うと、他の MCP クライアントを同じライブブラウザーキャンバスに接続できます。アプリを開き、Connect MCP を選択して、一時的な接続を有効にしてください。ペアリングしなくても、ネイティブ WebMCP は引き続き利用できます。レジストリメタデータは server.json にあります。