MCP Stdio Wrapper

MCP Stdio Wrapper ist ein kleiner MCP-Server, der es einem MCP-Client ermöglicht, einen anderen stdio-MCP-Server bei Bedarf zu starten und zu untersuchen.

Seine Aufgabe ist es, eine mühsame MCP-Entwicklungsschleife zu beseitigen: Einige gängige MCP-Hosts cachen den eigentlichen Serverprozess, sodass man nach jeder Codeänderung das Fenster neu laden oder den Extension-Host neu starten muss, nur um die Änderung einem Smoke-Test zu unterziehen. Dieser Wrapper sitzt vor dem eigentlichen Zielserver und bietet Ihrem Agenten eine stabile Brücke für wiederholte Smoke-Tests, während sich die Zielimplementierung darunter ständig ändert.

Warum existiert dieses Projekt?

Verwenden Sie dieses Projekt, wenn:

• Sie aktiv einen stdio-MCP-Server entwickeln

• Ihr Haupt-MCP-Host den Zielserver nach jeder Änderung nicht zuverlässig neu lädt

• Sie dennoch möchten, dass ein Agent während der Entwicklung Tools auflistet, Tools aufruft, Ressourcen liest und Prompts untersucht

Dieses Projekt ist bewusst eng gefasst. Es ist für die lokale Entwicklung und Smoke-Tests gedacht, nicht für das Proxying von Produktionsdatenverkehr.

Der Wrapper stellt außerdem integrierte Anleitungen bereit, die Agenten direkt entdecken können:

• Ressource: wrapper://how-to-use

• Prompt: tool_usage_guide

Related MCP server: Multi MCP

Funktionsweise

Der Wrapper bietet zwei Modi.

Standard-One-Shot-Tools:

• stdio_mcp_list_tools

• stdio_mcp_call_tool

• stdio_mcp_list_resources

• stdio_mcp_read_resource

• stdio_mcp_list_prompts

• stdio_mcp_get_prompt

Jeder One-Shot-Brückenaufruf:

1. startet den stdio-MCP-Zielserver

2. führt einen MCP-Vorgang aus

3. gibt das Ergebnis zurück

4. schließt den Zielprozess

Optionale Sitzungs-Tools:

• stdio_mcp_open_session

• stdio_mcp_get_session

• stdio_mcp_close_session

• stdio_mcp_session_list_tools

• stdio_mcp_session_call_tool

• stdio_mcp_session_list_resources

• stdio_mcp_session_read_resource

• stdio_mcp_session_list_prompts

• stdio_mcp_session_get_prompt

Das bedeutet:

• ein sauberer Zielprozess pro One-Shot-Smoke-Test

• eine explizite, kurzlebige Sitzungsoption für mehrstufige Validierungen

• kein verstecktes Caching-Verhalten

• einfacheres Debugging, da stderr des Ziels bei Fehlern angezeigt wird

Schnellstart

Klonen Sie das Repo und installieren Sie die Abhängigkeiten:

nvm use
npm install

Starten Sie den Wrapper:

npm start

Das veröffentlichte Paket kann auch direkt ausgeführt werden mit:

npx mcp-stdio-wrapper

Das Paket ist unter https://www.npmjs.com/package/mcp-stdio-wrapper veröffentlicht.

Dieses Repo ist für npm Trusted Publishing über GitHub Actions eingerichtet. Siehe Veröffentlichungs-Checkliste für die anfängliche Veröffentlichungssequenz und die OIDC Trusted-Publishing-Übergabe.

Verweisen Sie Ihren Haupt-MCP-Client auf diesen Wrapper und verwenden Sie dann eines der Brücken-Tools mit einer Start-Eingabe wie:

{
  "command": "node",
  "args": ["C:\\path\\to\\your-mcp\\dist\\index.js"],
  "cwd": "C:\\path\\to\\your-mcp",
  "inheritParentEnv": true,
  "env": {
    "EXAMPLE_ENV": "value"
  },
  "startupTimeoutMs": 30000,
  "operationTimeoutMs": 30000
}

Bitten Sie dann Ihren Agenten:

• Tools vom eigentlichen Zielserver aufzulisten

• nach jeder Codeänderung ein Ziel-Tool aufzurufen

• Ressourcen-Lesevorgänge oder Prompts zu verifizieren

Verwenden Sie den One-Shot-Modus für die erste Inspektion und kleine zustandslose Aufrufe. Wenn das Ziel jobId-artige Handles zurückgibt, einen In-Memory-Zustand zwischen Aufrufen erwartet oder einfach einen aufwendigen Startvorgang hat, öffnen Sie zuerst eine explizite Sitzung und verwenden Sie dann die stdio_mcp_session_*-Tools, bevor Sie sie schließen.

Tool-Oberfläche

Allgemeine Startfelder:

• command: Ziel-Executable

• args: Argumente für den Zielbefehl

• cwd: optionales Arbeitsverzeichnis des Ziels

• inheritParentEnv: wenn true, wird die Umgebung des Wrapper-Prozesses in den Zielstart übernommen

• env: zusätzliche Umgebungsvariablen für das Ziel

• startupTimeoutMs: optionales Timeout für One-Shot-Start und MCP-Initialisierung

• operationTimeoutMs: optionales Timeout für One-Shot-Vorgänge

• timeoutMs: Legacy-One-Shot-Abkürzung für beide Phasen; Sitzungs-Tools verwenden weiterhin timeoutMs

Brückenvorgänge:

• stdio_mcp_list_tools: Ziel-Tools untersuchen

• stdio_mcp_call_tool: ein Ziel-Tool aufrufen

• stdio_mcp_list_resources: Ziel-Ressourcen untersuchen

• stdio_mcp_read_resource: eine Ziel-Ressource lesen

• stdio_mcp_list_prompts: Ziel-Prompts untersuchen

• stdio_mcp_get_prompt: eine Ziel-Prompt-Definition abrufen

Sitzungsvorgänge:

• stdio_mcp_open_session: einen Zielprozess starten und für mehrere Vorgänge aktiv halten

• stdio_mcp_get_session: Sitzungsdiagnosen wie Status, Zeitstempel, PID, Exit-Code und stderr-Ende untersuchen

• stdio_mcp_close_session: eine aktive oder beendete Sitzung schließen und deren Datensatz entfernen

• stdio_mcp_session_list_tools: Tools über eine bestehende Sitzung untersuchen

• stdio_mcp_session_call_tool: ein Ziel-Tool über eine bestehende Sitzung aufrufen

• stdio_mcp_session_list_resources: Ressourcen über eine bestehende Sitzung untersuchen

• stdio_mcp_session_read_resource: eine Ziel-Ressource über eine bestehende Sitzung lesen

• stdio_mcp_session_list_prompts: Prompts über eine bestehende Sitzung untersuchen

• stdio_mcp_session_get_prompt: eine Ziel-Prompt-Definition über eine bestehende Sitzung abrufen

Anleitungsflächen des Wrappers:

• wrapper://how-to-use: Klartext-Anleitung zur Verwendung

• tool_usage_guide: Prompt-Form derselben Anweisungen

Der Sitzungsmodus ist besser geeignet, wenn:

• das Ziel verzögerte Handles wie jobId zurückgibt

• Folgeaufrufe denselben aktiven Zielprozess treffen müssen

• der Start des Ziels so aufwendig ist, dass eine Wiederholung die eigentliche Feedbackschleife verschleiert

Sicherheitshinweise

• Dieser Wrapper startet beliebige Befehle, die vom Aufrufer bereitgestellt werden.

• Behandeln Sie Startargumente und Umgebungsvariablen als vertraulich.

• Verwenden Sie ihn nur mit vertrauenswürdigen Zielbefehlen und vertrauenswürdigen lokalen Projekten.

• Stellen Sie dies nicht als öffentlichen Multi-Tenant-Dienst bereit.

Dokumentation

• Einrichtungsanleitung

• Tool-Referenz

• Fehlerbehebung

• Branching-Strategie

• Wartungsanleitung

• Veröffentlichungs-Checkliste

• Fuzzing-Workflow

• Sicherheitsrichtlinie

• Mitwirken

• Changelog

Star-Verlauf