MedEval MCP (lokal)

Nur-lokales Model-Context-Protocol-Gateway für die private MedEval-Arbeitsumgebung für Medizinprodukte-Regulierung.

Es ermöglicht einem MCP-Client, MedEval-Arbeitsbereiche, kanonisierte Materialien, Evidenzabruf, CEP/CER-Erstellung und -Bewertung, Workflow-Beobachtbarkeit und unveränderliche Dokumentrevisionen zu bedienen. MedEval bleibt das System of Record; dieses Projekt ist ein schlanker, begrenzter Adapter.

Sicherheitsgrenze

• Nur stdio-Transport; kein Netzwerk-MCP-Listener

• Verbindet standardmäßig mit Loopback, mit explizitem Opt-in für vertrauenswürdige private Netzwerk-IPs

• Explizite Arbeitsbereichs-/Aufgabenkennungen

• Zugelassene lokale Upload-Wurzeln

• Keine Lösch-, Shell-, Bereitstellungs- oder Geheimnisverwaltungs-Tools

• Asynchrone Starts geben Aufgaben-IDs zurück und müssen abgefragt, nicht dupliziert werden

• Produktfakten können nicht aus externer Literatur abgeleitet werden

• Dokumentbearbeitungen erfordern die aktuelle base_revision_id

Siehe SECURITY.md.

Anforderungen

• Windows oder eine andere Python-3.11+-Umgebung

• MedEval läuft unter http://127.0.0.1:8000

• Python-Paketabhängigkeiten aus pyproject.toml

Installation

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

Der MCP-Prozess liest normale Umgebungsvariablen. MCP-Clients stellen diese in der Regel in ihrer Serverkonfiguration bereit, anstatt .env automatisch zu laden.

Konfiguration

Mindestkonfiguration für lokal:

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

Wenn MedEval MEDEVAL_API_TOKEN aktiviert, geben Sie diesem MCP-Prozess dasselbe MEDEVAL_API_TOKEN; es wird als X-API-Token gesendet. Ein signiertes Browser-/Sitzungstoken kann stattdessen als MEDEVAL_BEARER_TOKEN bereitgestellt werden.

macOS-Client zu einem vertrauenswürdigen LAN-Backend

Wenn MedEval auf einem anderen Computer im selben vertrauenswürdigen LAN lauscht, verwenden Sie dessen tatsächliche private IP und stimmen Sie explizit zu:

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

Der MCP bleibt ein lokaler stdio-Prozess auf dem Mac. Öffentliche IP-Adressen und Domainnamen werden weiterhin abgelehnt.

Von Codex aus verbinden

Verwenden Sie examples/codex.mcp.json als MCP-Serverdefinition. Der Befehl muss auf das Python in .venv dieses Projekts zeigen und Folgendes verwenden:

-m medeval_mcp.server

Starten Sie Codex nach der Änderung der MCP-Konfiguration neu und bitten Sie es dann, medeval_health aufzurufen.

Manuell ausführen

MCP stdio verwendet die Standardausgabe für Protokollnachrichten, sodass eine manuelle Ausführung inaktiv erscheint:

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

Verwenden Sie einen MCP-Client oder Inspector, um damit zu interagieren.

Der gebündelte lokale Launcher setzt das Loopback-Backend und die Upload-Wurzeln, bevor stdio gestartet wird:

.\scripts\run_local.ps1

Protokoll- und Backend-Smoke-Test:

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

Tool-Oberfläche

Die erste Version bietet 21 Tools:

• Arbeitsbereich: Health, Projektliste, Arbeitsbereich erstellen/abrufen, Arbeitsbereichsdokumente

• Beobachtbarkeit: Ausführungsliste, Ausführungsdetails, begrenzter Agentenkontext

• Evidenz: Projektdokumente, Evidenzsuche, Abschnittskontext

• Aufnahme: Zugelassener lokaler Material-Upload und Kanonisierung

• Generierung: Vorlagenliste, Generierung starten, Generierungs-/Aufgabenstatus

• Bewertung: Bewertung starten

• Revisionen: Liste, begrenztes Lesen, Diff, Optimistic-Lock-Patch

medeval_start_generation verwendet standardmäßig tag_index_agent, das MedEvals abhängigkeitsseriellen segmentierten Writer verwendet. Vollkontext-Strategien bleiben Opt-in.

Tests

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

Die Tests verwenden Mock-HTTP-Transports und starten keine LLM-Generierung oder verbrauchen Modellkontingent. Ein separater Integrations-Smoke-Test listet MCP-Tools auf und ruft den bereits laufenden lokalen /api/health-Endpunkt auf.

Noch nicht enthalten

• Remote-Streamable-HTTP-Transport

• xiaoyuu.me-Bereitstellung

• Mehrbenutzer-API-Schlüssel und Arbeitsbereichsbesitz

• Remote-Upload-Staging

• Destruktive Projekt-/Aufgabenlöschung