mcp-wsl-exec

Ein Model Context Protocol (MCP)-Server zur Ausführung von Befehlen in Windows Subsystem for Linux (WSL)-Umgebungen. Dieser Server bietet sichere Befehlsausführung mit integrierten Sicherheitsfunktionen und Validierung.

Merkmale

• 🔒 Sichere Befehlsausführung in WSL-Umgebungen

• ⚡ Integrierte Sicherheitsfunktionen:

  • Erkennung gefährlicher Befehle

  • Befehlsbestätigungssystem

  • Verhinderung der Pfaddurchquerung

  • Befehlsbereinigung

• 📁 Unterstützung von Arbeitsverzeichnissen

• ⏱️ Befehls-Timeout-Funktionalität

• 🔍 Detaillierte Formatierung der Befehlsausgabe

• ❌ Fehlerbehandlung und Validierung

• 🛡️ Schutz vor Shell-Injektion

Related MCP server: Terminal Controller for MCP

Konfiguration

Dieser Server muss über Ihren MCP-Client konfiguriert werden. Hier sind Beispiele für verschiedene Umgebungen:

Cline-Konfiguration

Fügen Sie dies zu Ihren Cline MCP-Einstellungen hinzu:

Claude Desktop-Konfiguration

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:

API

Der Server implementiert zwei MCP-Tools:

Befehl ausführen

Führen Sie einen Befehl in WSL mit Sicherheitsprüfungen und Validierung aus.

Parameter:

• command (Zeichenfolge, erforderlich): Auszuführender Befehl

• working_dir (Zeichenfolge, optional): Arbeitsverzeichnis für die Befehlsausführung

• timeout (Zahl, optional): Timeout in Millisekunden

Bestätigungsbefehl

Bestätigen Sie die Ausführung eines gefährlichen Befehls, der durch Sicherheitsüberprüfungen gekennzeichnet wurde.

Parameter:

• confirmation_id (Zeichenfolge, erforderlich): Von execute_command empfangene Bestätigungs-ID

• confirm (Boolesch, erforderlich): Ob mit der Befehlsausführung fortgefahren werden soll

Sicherheitsfunktionen

Erkennung gefährlicher Befehle

Der Server verwaltet eine Liste potenziell gefährlicher Befehle, die vor der Ausführung eine ausdrückliche Bestätigung erfordern, darunter:

• Dateisystemoperationen (rm, rmdir, mv)

• Systembefehle (Herunterfahren, Neustart)

• Paketverwaltung (apt, yum, dnf)

• Dateiumleitungen (>, >>)

• Berechtigungsänderungen (chmod, chown)

• Und mehr...

Befehlsbereinigung

Alle Befehle werden bereinigt, um Folgendes zu verhindern:

• Shell-Metazeichen-Injektion

• Pfaddurchquerungsversuche

• Home-Verzeichnis-Referenzen

• Gefährliche Befehlsverkettung

Entwicklung

Aufstellen

1. Klonen Sie das Repository

2. Installieren Sie Abhängigkeiten:

3. Erstellen Sie das Projekt:

4. Im Entwicklungsmodus ausführen:

Veröffentlichen

Das Projekt verwendet Änderungssätze zur Versionsverwaltung. So veröffentlichen Sie:

1. Erstellen Sie einen Änderungssatz:

2. Versionieren Sie das Paket:

3. Auf npm veröffentlichen:

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Lizenz

MIT-Lizenz – Einzelheiten finden Sie in der Datei LICENSE .

Danksagung

• Basierend auf dem Model Context Protocol

• Entwickelt für die sichere Ausführung von WSL-Befehlen