mcp-wsl-exec

Integrations

  • Allows execution of commands in Windows Subsystem for Linux (WSL) environments with security features

  • Provides protection against shell injection and secure command execution with safety features

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

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:

{ "mcpServers": { "mcp-wsl-exec": { "command": "npx", "args": ["-y", "mcp-wsl-exec"] } } }

Claude Desktop-Konfiguration

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

{ "mcpServers": { "mcp-wsl-exec": { "command": "npx", "args": ["-y", "mcp-wsl-exec"] } } }

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:
pnpm install
  1. Erstellen Sie das Projekt:
pnpm build
  1. Im Entwicklungsmodus ausführen:
pnpm dev

Veröffentlichen

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

  1. Erstellen Sie einen Änderungssatz:
pnpm changeset
  1. Versionieren Sie das Paket:
pnpm changeset version
  1. Auf npm veröffentlichen:
pnpm release

Beitragen

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

Lizenz

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

Danksagung

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Ein sicherer MCP-Server für Windows-Subsysteme für Linux-Umgebungen, der die sichere Ausführung von Befehlen mit umfassender Validierung und Schutz vor Schwachstellen wie Shell-Injection und gefährlichen Befehlen ermöglicht.

  1. Merkmale
    1. Konfiguration
      1. Cline-Konfiguration
      2. Claude Desktop-Konfiguration
    2. API
      1. Befehl ausführen
      2. Bestätigungsbefehl
    3. Sicherheitsfunktionen
      1. Erkennung gefährlicher Befehle
      2. Befehlsbereinigung
    4. Entwicklung
      1. Aufstellen
      2. Veröffentlichen
    5. Beitragen
      1. Lizenz
        1. Danksagung

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            An MCP server to run commands.
            Last updated -
            2
            556
            133
            TypeScript
            MIT License
            • Apple
          • A
            security
            A
            license
            A
            quality
            A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
            Last updated -
            1
            74
            Python
            MIT License
            • Apple
          • A
            security
            A
            license
            A
            quality
            A secure MCP server for executing whitelisted shell commands with resource and timeout controls, designed for integration with Claude and other MCP-compatible LLMs.
            Last updated -
            20
            143
            2
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
            Last updated -
            9
            350
            105
            JavaScript
            MIT License

          View all related MCP servers

          ID: wv6df94kb8