shellserver

Ein kleiner Model Context Protocol (MCP)-Server, der mit dem Python MCP SDK (FastMCP) erstellt wurde. Er stellt ein Tool bereit, das Shell-Befehle auf der Maschine ausführt, auf der der Serverprozess läuft.

Anforderungen

• Python 3.14+ (siehe pyproject.toml)

• uv zur Installation und Ausführung von Abhängigkeiten

Related MCP server: Shell MCP Server

Einrichtung

Klonen oder kopieren Sie dieses Repository und führen Sie dann vom Projektstammverzeichnis aus:

uv sync

Ausführen des Servers

Der Server verwendet den stdio-Transport (Standard für FastMCP).

uv run python server.py

Leiten Sie keine zusätzlichen Daten vom Serverprozess an stdout weiter; MCP verwendet stdout für JSON-RPC. Protokollierungen in server.py werden an stderr weitergeleitet.

Tool: terminal_tool

Das Tool gibt einen einzelnen Textblock zurück, der exit_code, stdout und stderr enthält. Wenn der Befehl das Zeitlimit überschreitet, wird der Prozess beendet und die Antwort zeigt ein Timeout an.

Verbinden eines Clients (Beispiel für die lokale Ausführung)

Verweisen Sie Ihren MCP-Host auf uv mit diesem Projekt als Arbeitsverzeichnis. Beispiel für die Konfigurationsstruktur:

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/shellserver"
    }
  }
}

Passen Sie den Schlüsselnamen und cwd an Ihren Editor oder Client an.

Sicherheit

Dieser Server führt beliebige Shell-Befehle auf dem Host aus. Jeder, der MCP-Tools gegen diesen Server aufrufen kann, hat effektiv Shell-Zugriff auf diese Maschine. Verwenden Sie ihn nur auf vertrauenswürdigen Hosts, mit vertrauenswürdigen Clients und mit einem klaren Verständnis des Risikos.