MCP-Server

Der MCP-Server (Model Context Protocol) veröffentlicht Operationen der MicroLab-Engine als Tools für KI-Clients (Claude Code, Claude Desktop, Cursor…). Es ist dieselbe Oberfläche, die der Copilot der App nutzt. Die Tools werden aus dem Operationsregister generiert, sodass MCP und CLI nicht auseinanderlaufen.

Heute veröffentlicht er 42 Tools, 2 Resources und 3 Ablauf-Prompts.

Kuratierte Oberfläche

Es ist kein Abbild des Registers (92 Operationen): Die KI bedient das Labor —starten, testen, mocken, debuggen—, während die Katalog-Autorenschaft (Micros und Szenarien erstellen, Maschineneinstellungen bearbeiten, Import/Export per Datei) in der App und im CLI bleibt. Ein Modell wählt schlechter, je länger die Liste ist. Nichts geht verloren: Das Verborgene ist weiterhin in microlab ops, im CLI und im Control server.

Verbindung über stdio (die übliche)

Der Client startet microlab mcp als Kindprozess. Er benötigt die kompilierte Engine (npm run build:electron), und es ist ratsam, absolute Pfade und ein explizites -p zu verwenden (der Projektordner mit .microlab/).

Claude Code:

claude mcp add microlab -- node C:\werkzeuge\micro-lab\bin\microlab.js mcp -p C:\projekte\mein-projekt

Claude Desktop / Cursor (claude_desktop_config.json oder .cursor/mcp.json):

{
  "mcpServers": {
    "microlab": {
      "command": "node",
      "args": ["C:\\werkzeuge\\micro-lab\\bin\\microlab.js", "mcp", "-p", "C:\\projekte\\mein-projekt"]
    }
  }
}

Mit der globalen ausführbaren Datei (npm link) genügt "command": "microlab", "args": ["mcp", "-p", "..."].

Verbindung über HTTP (aktive Engine)

Mit einer aktiven Engine (die App offen oder der Daemon) ist derselbe Server über Streamable HTTP an der Route /mcp des Control servers verfügbar, für Clients, die keine Prozesse starten. Die URL und das Token kommen aus control.json; jede Anfrage trägt Authorization: Bearer <token>.

Was er veröffentlicht

• Tools — 42, nach Domäne gruppiert (Szenario-Lebenszyklus, Debugging, Docker, schreibgeschützter Katalog, Mocks…). Jedes trägt readOnlyHint- oder destructiveHint-Annotationen, wo es zutrifft, damit der Client entscheidet, was ohne Bestätigung auszuführen ist.
• Resources — microlab://guide (Bedienungsleitfaden für KIs, in Markdown) und microlab://status (JSON-Snapshot: Version, Pfade, aktive Engine, aktives Szenario und Status seiner Micros).
• Prompts — drei Ablaufrezepte: levantar-y-probar, mockear-dependencia und depurar-micro.

Ausführungsmodell

Wie das CLI: Wenn es eine aktive Engine gibt, wird das Tool gegen sie ausgeführt (gleicher Zustand wie die UI); wenn nicht, laufen die zustandslosen Tools in-proc. scenario_start und scenario_up_and_wait starten den Daemon, wenn er fehlt; die Micros überleben die MCP-Sitzung (das Schließen des KI-Clients stoppt sie nicht; zum Stoppen scenario_stop).

Zugriff

In Projekten mit Anmeldung erfordert das MCP die Fähigkeit mcp (unabhängig von cli). Ohne sie endet stdio mit exit 5 und HTTP antwortet 403. Siehe Fähigkeiten.

Siehe auch

• Copilot — die gleiche Oberfläche in der App.
• Control server · CLI-Befehle