Servidor MCP local (stdio) con Docker

Este proyecto es un servidor MCP local mínimo que expone una herramienta run_command a través de stdio.

Configuración

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

Inicie el script usando:

uv run main.py

Nota: a partir de MCP 2.0, no habrá salida en la consola después de que el servidor se inicie. El proceso permanece activo y espera mensajes stdio de un cliente MCP. Puede inspeccionarlo usando el depurador en una nueva sesión de terminal.

Inicie el inspector:

npx -y @modelcontextprotocol/inspector

Luego, en la interfaz del inspector:

• Transporte: stdio

• Comando: uv

• Argumentos: run, python, main.py

• Directorio de trabajo: ~path-to-directory/local-mcp-with-docker

El inspector debería mostrar la herramienta registrada run_command y permitirle llamarla directamente.

Related MCP server: mcp-stdio

Construir la imagen Docker

docker build -t terminal_tool_docker .

Esto crea la imagen Docker local utilizada por la configuración MCP de Claude Desktop.

Configuración de Claude Desktop

Agregue esto a su archivo de configuración MCP de Claude Desktop:

{
  "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"
      ]
    }
  }
}

Esto monta su espacio de trabajo en el contenedor y apunta el servidor al directorio de trabajo correcto dentro del contenedor.

Captura de pantalla de Claude