Universal MCP Lab

Ein minimaler Proof of Concept zur Validierung des dynamischen Fähigkeitserwerbs hinter einer stabilen MCP-Oberfläche.

Hypothese

Ein Agent beginnt mit sechs stabilen Werkzeugen. Er verbindet einen OpenAPI-Dienst, entdeckt neue interne Fähigkeiten, inspiziert sie und ruft sie auf, ohne den veröffentlichten MCP-Katalog zu ändern.

Vorgesehene stabile Oberfläche:

• services.connect

• services.disconnect

• services.list

• capabilities.list

• capabilities.describe

• capabilities.invoke

Die PoC gewährt keinen direkten Zugriff auf das Gerät, legt keine beliebige Shell offen und speichert keine Anmeldeinformationen.

Related MCP server: openapi-mcp

Lokalen Test ausführen

python -m unittest discover -s tests -v
python scripts/demo.py

Echtes MCP über stdio

Phase 3 integriert einen echten MCP-Server mit den sechs stabilen Werkzeugen. Installieren Sie die deklarierte Abhängigkeit und lassen Sie einen MCP-Host den Prozess starten:

pip install -e .
python -m entradas.mcp.server

Der Prozess zeigt keine Benutzeroberfläche und darf nicht in stdout schreiben: Er erwartet MCP-Nachrichten über stdin. Der Test tests/test_mcp_protocol.py fungiert als echter MCP-Client, überprüft tools/list, verbindet das synthetische OpenAPI und bestätigt, dass sich der öffentliche Katalog nicht ändert.

Dieser lokale Transport ist bewusst eingeschränkt: Er veröffentlicht nichts über HTTP, enthält kein OAuth, verbindet nicht mit dem Computer und aktiviert keine Schreiberlaubnisse.

Folgtet man also. Um einen HTTP-Lesezugriff im Labor zu erlauben, konfigurieren Sie vor dem Start eine lokale Allowlist. Das per MCP gesendete OpenAPI-Dokument kann dieses Ziel nicht verändern:

$env:UNIVERSAL_MCP_READ_BASE_URLS = '{"customers":"https://api.example.test"}'
python -m entradas.mcp.server

Es werden nur GET-Anfragen an konfigurierte Dienste ausgeführt; es gibt eine Zeitbeschränkung, eine Größengrenze, zwingend JSON, keine Weiterleitungen und keine Wiederholungsversuche. Die Testsuite ohne Internet: Sie startet einen temporären lokalen Endpunkt, um diesen Ablauf zu verifizieren.

Lokaler Knoten des Eigentümers

Der PC-Knoten ist ein separater lokaler MCP-Prozess, keine Remote-Steuerungsfunktion. Nur der Eigentümer des Geräts kann ihn starten und einen expliziten Ordner festlegen:

$env:UNIVERSAL_MCP_OWNER_ALLOWED_ROOT = 'C:\carpeta-autorizada'
python -m entradas.pc_node.server

Sein einziges Werkzeug ist pc.read_text(relative_path). Er umfasst keine Shell, keine Schreibvorgänge, keine Laufwerkserkundung, keinen Browser, keine Prozesse und keine Netzwerk-Listener. Tunnelbau und Authentifizierung zwischen Gateway und diesem Knoten gehören zu einer späteren Phase.

Action Boundary für Schreibvorgänge

Ein Schreibvorgang akzeptiert nicht approved=true. Die erste Anforderung gibt eine Bestätigungsreferenz zurück; eine vertrauenswürdige menschliche Schnittstelle muss genau diese Handlung außerhalb von MCP genehmigen. Die resultierende Autorisierung istewig gültig, an dieselben Argumente gebunden und wird vor dem Executor verbraucht. Dies ermöglicht noch keine Schreibvorgänge auf dem PC-Knoten.

Status

Architektur + Labor-Fähigkeitskern + tiefes ECA vorbereitet. Weitere Informationen finden Sie in STATUS.md und docs/PLAYBKED.md.