MedEval MCP（ローカル）

プライベートなMedEval医療機器規制ワークベンチ向けの、ローカルのみのModel Context Protocolゲートウェイ。

MCPクライアントがMedEvalワークスペース、正規化されたマテリアル、エビデンス検索、CEP/CER生成と評価、ワークフロー可観測性、不変のドキュメントリビジョンを操作できるようにします。MedEvalは引き続きシステム・オブ・レコードであり、このプロジェクトは薄く境界のあるアダプターです。

セーフティ境界

• stdioトランスポートのみ。ネットワークMCPリスナーなし

• デフォルトでループバックに接続し、信頼できるプライベートネットワークIPへの明示的なオプトインを提供

• 明示的なワークスペース/タスク識別子

• 許可リスト化されたローカルアップロードルート

• 削除、シェル、デプロイ、シークレット管理ツールなし

• 非同期開始はタスクIDを返し、重複ではなくポーリングする必要がある

• 製品事実は外部文献から導出できない

• ドキュメント編集には現在のbase_revision_idが必要

SECURITY.mdを参照。

要件

• Windowsまたはその他のPython 3.11+環境

• http://127.0.0.1:8000で実行中のMedEval

• pyproject.tomlからのPythonパッケージ依存関係

インストール

cd C:\path\to\medeval-mcp
py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[test]"
Copy-Item .env.example .env

MCPプロセスは通常の環境変数を読み取ります。MCPクライアントは通常、.envを自動的に読み込むのではなく、サーバー設定で環境変数を提供します。

設定

最小限のローカル設定：

MEDEVAL_BASE_URL=http://127.0.0.1:8000
MEDEVAL_PROJECT_ROOT=C:\path\to\medeval
MEDEVAL_ALLOWED_FILE_ROOTS=C:\path\to\medeval;C:\path\to\materials

MedEvalがMEDEVAL_API_TOKENを有効にしている場合は、このMCPプロセスに同じMEDEVAL_API_TOKENを指定します。これはX-API-Tokenとして送信されます。署名付きブラウザ/セッショントークンは、代わりにMEDEVAL_BEARER_TOKENとして指定できます。

信頼できるLANバックエンドへのmacOSクライアント

MedEvalが同じ信頼できるLAN内の別のコンピューターで待ち受けている場合は、そのリテラルなプライベートIPを使用し、明示的にオプトインします：

MEDEVAL_BASE_URL=http://192.168.0.166:8001
MEDEVAL_ALLOW_PRIVATE_NETWORK=true
MEDEVAL_PROJECT_ROOT=/Users/your-name/MedEval
MEDEVAL_ALLOWED_FILE_ROOTS=/Users/your-name/MedEval:/Users/your-name/Documents

MCPはMac上のローカルstdioプロセスとして残ります。パブリックIPアドレスとドメイン名は引き続き拒否されます。

Codexから接続

examples/codex.mcp.jsonをMCPサーバー定義として使用します。コマンドはこのプロジェクトの.venv Pythonを指し、次を使用する必要があります：

-m medeval_mcp.server

MCP設定を変更した後、Codexを再起動し、medeval_healthを呼び出すように依頼します。

手動実行

MCP stdioはプロトコルメッセージに標準出力を使用するため、手動実行はアイドル状態に見えます：

.\.venv\Scripts\python.exe -m medeval_mcp.server

MCPクライアントまたはInspectorを使用して操作します。

バンドルされたローカルランチャーは、stdioを開始する前にループバックバックエンドとアップロードルートを設定します：

.\scripts\run_local.ps1

プロトコルとバックエンドのスモークテスト：

.\.venv\Scripts\python.exe scripts\mcp_smoke.py --health

ツールサーフェス

最初のリリースでは21のツールを提供します：

• ワークスペース：ヘルス、プロジェクト一覧、ワークスペースの作成/取得、ワークスペースドキュメント

• 可観測性：実行一覧、実行詳細、境界付きエージェントコンテキスト

• エビデンス：プロジェクトドキュメント、エビデンス検索、セクションコンテキスト

• 取り込み：許可リスト化されたローカルマテリアルのアップロードと正規化

• 生成：テンプレート一覧、生成開始、生成/タスクステータス

• 評価：評価開始

• リビジョン：一覧、境界付き読み取り、差分、楽観的ロックパッチ

medeval_start_generationはデフォルトでtag_index_agentを使用します。これはMedEvalの依存関係シリアルセグメント化ライターを使用します。フルコンテキスト戦略はオプトインのままです。

テスト

.\.venv\Scripts\python.exe -m pytest

テストはモックHTTPトランスポートを使用し、LLM生成を開始したりモデルクォータを消費したりしません。別の統合スモークテストはMCPツールを一覧表示し、すでに実行中のローカル/api/healthエンドポイントを呼び出します。

未含の機能

• リモートStreamable HTTPトランスポート

• xiaoyuu.meデプロイ

• マルチユーザーAPIキーとワークスペース所有権

• リモートアップロードステージング

• 破壊的なプロジェクト/タスク削除