Docker容器管理服务

# Clone or navigate to the repository
cd docker-mcp-server

# Build the binary
go build -o docker-mcp-server

# Make it executable (Unix-like systems)
chmod +x docker-mcp-server

# Linux (amd64)
GOOS=linux GOARCH=amd64 go build -o docker-mcp-server-linux-amd64

# macOS (arm64, Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -o docker-mcp-server-darwin-arm64

# macOS (amd64, Intel)
GOOS=darwin GOARCH=amd64 go build -o docker-mcp-server-darwin-amd64

# Windows (amd64)
GOOS=windows GOARCH=amd64 go build -o docker-mcp-server-windows-amd64.exe

{
  "mcpServers": {
    "docker": {
      "command": "/absolute/path/to/docker-mcp-server",
      "args": [],
      "env": {
        "DOCKER_HOST": "unix:///var/run/docker.sock"
      }
    }
  }
}

{
  "mcpServers": {
    "docker-remote": {
      "command": "/path/to/docker-mcp-server",
      "env": {
        "DOCKER_HOST": "tcp://192.168.1.100:2375"
      }
    }
  }
}

{
  "mcpServers": {
    "docker-ssh": {
      "command": "/path/to/docker-mcp-server",
      "env": {
        "DOCKER_HOST": "ssh://user@remote-host"
      }
    }
  }
}

# Install MCP Inspector (Node.js required)
npx @modelcontextprotocol/inspector ./docker-mcp-server

# The inspector will open in your browser
# Test available tools:
# 1. tools/list - Should show 27 tools (2 system + 8 container + 6 image + 6 network + 5 volume)
# 2. tools/call ping - Should return "Docker daemon is reachable"
# 3. tools/call version - Should return Docker version information
# 4. tools/call list_containers - Should list running containers
# 5. tools/call list_images - Should list Docker images
# 6. tools/call list_networks - Should list Docker networks
# 7. tools/call list_volumes - Should list Docker volumes

# Verify Docker is running
docker ps

# Build the server
go build -o docker-mcp-server

# Test the binary (it will wait for MCP protocol input on stdin)
# Press Ctrl+C to exit
./docker-mcp-server

Claude: "List all running Docker containers"

Claude: "Show me all containers including stopped ones"

Claude: "Start the container named my-nginx"

Claude: "Stop container abc123 with 30 second timeout"

Claude: "Get the last 100 lines of logs from container my-app"
Claude: "Show all logs from container nginx-prod with timestamps"

Claude: "Run a new nginx container named web-server on port 8080"
Claude: "Create and start a redis container with port 6379 exposed"

Claude: "Inspect container my-app and show its configuration"

Claude: "Remove the stopped container abc123"
Claude: "Force remove container xyz789 and its volumes"

Claude: "Restart the container named api-server"

Claude: "List all Docker images on my system"

Claude: "Search for official nginx images on Docker Hub"

Claude: "Pull the nginx:alpine image from Docker Hub"
Claude: "Pull redis:latest"

Claude: "Push myapp:latest to Docker Hub"

Claude: "Remove the image nginx:old-version"
Claude: "Force remove the image abc123"

Claude: "Build an image from Dockerfile in current directory with tag myapp:v1.0"
Claude: "Build image with context ./app and tags myapp:latest, myapp:1.0"

Claude: "List all Docker networks"
Claude: "Show me Docker networks filtered by driver=bridge"

Claude: "Create a new bridge network named my-app-network"
Claude: "Create an internal network named backend-net with subnet 172.20.0.0/16"

Claude: "Inspect the bridge network and show its configuration"
Claude: "Get details about the my-app-network network"

Claude: "Connect container my-app to network my-app-network"
Claude: "Connect nginx container to backend-net with alias web-server"

Claude: "Disconnect container my-app from network my-app-network"

Claude: "Remove the network my-app-network"

Claude: "List all Docker volumes"
Claude: "Show me volumes that are dangling"

Claude: "Create a new volume named my-data"
Claude: "Create a volume with custom driver options"

Claude: "Inspect volume my-data and show its configuration"

Claude: "Remove the volume old-data"
Claude: "Force remove volume my-data even if it's in use"

Claude: "Remove all unused Docker volumes to free up space"

docker-mcp-server/
├── main.go                    # Entry point
├── go.mod                     # Go module definition
├── internal/
│   ├── docker/
│   │   ├── client.go          # Docker client wrapper
│   │   ├── system.go          # System operations (ping, version)
│   │   ├── container.go       # Container operations (Phase 2)
│   │   ├── image.go           # Image operations (Phase 3)
│   │   ├── network.go         # Network operations (Phase 4)
│   │   └── volume.go          # Volume operations (Phase 4)
│   ├── tools/
│   │   ├── registry.go        # Tool registration
│   │   ├── system.go          # System tool handlers
│   │   ├── container.go       # Container tool handlers (Phase 2)
│   │   ├── image.go           # Image tool handlers (Phase 3)
│   │   ├── network.go         # Network tool handlers (Phase 4)
│   │   └── volume.go          # Volume tool handlers (Phase 4)
│   └── types/
│       ├── inputs.go          # Input struct definitions
│       └── errors.go          # Error types
└── examples/
    └── claude_desktop_config.json

# Check Docker is running
docker ps

# Check Docker socket permissions
ls -la /var/run/docker.sock

# View server logs (they go to stderr)
./docker-mcp-server 2>&1 | tee server.log