Lokaler (stdio) MCP-Server mit Docker

Dieses Projekt ist ein minimaler lokaler MCP-Server, der ein run_command-Tool über stdio bereitstellt.

Setup

cd ~path-to-directory/local-mcp-with-docker
uv sync

Starten Sie das Skript mit:

uv run main.py

Hinweis: Ab MCP 2.0 gibt es nach dem Start des Servers keine Ausgabe in der Konsole. Der Prozess bleibt aktiv und wartet auf stdio-Nachrichten von einem MCP-Client. Sie können ihn mit dem Debugger in einer neuen Terminalsitzung überprüfen.

Starten Sie den Inspektor:

npx -y @modelcontextprotocol/inspector

Dann in der Inspektor-Oberfläche:

• Transport: stdio

• Befehl: uv

• Args: run, python, main.py

• Arbeitsverzeichnis: ~path-to-directory/local-mcp-with-docker

Der Inspektor sollte das registrierte Tool run_command anzeigen und Ihnen erlauben, es direkt aufzurufen.

Related MCP server: mcp-stdio

Erstellen des Docker-Images

docker build -t terminal_tool_docker .

Dies erstellt das lokale Docker-Image, das von der Claude Desktop MCP-Konfiguration verwendet wird.

Claude Desktop-Konfiguration

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

{
  "mcpServers": {
    "local-mcp-with-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "-e",
        "WORKSPACE_DIR=/root/mcp/workspace",
        "-v",
        "path-to-directory/local-mcp-with-docker:/root/mcp/workspace",
        "terminal_tool_docker"
      ]
    }
  }
}

Dies mountet Ihren Arbeitsbereich in den Container und weist den Server auf das richtige Arbeitsverzeichnis innerhalb des Containers hin.

Claude Screenshot