What is Mcp Server Docker

mcp-server-docker is a Docker-based server implementing the Model Context Protocol (MCP), designed to integrate seamlessly with Docker Desktop on Windows, providing advanced automation and interaction capabilities for developers and tools.

Use cases

Use cases include automating the management of Docker containers in development workflows, integrating with development tools for improved productivity, and facilitating testing and deployment processes in containerized environments.

How to use

To use mcp-server-docker, first install Docker Desktop for Windows and configure it to expose the daemon on tcp://localhost:2375 without TLS. Then, run the server using the provided command in your application configuration.

Key features

Key features include container lifecycle management, such as listing containers, retrieving container information, and starting containers, all of which facilitate efficient management of Docker containers.

Where to use

mcp-server-docker is primarily used in software development environments, particularly for developers working with Docker containers on Windows, enabling automation and enhanced interaction with containerized applications.

Docker MCP Server

The Docker MCP Server is a Model Context Protocol (MCP)
server that provides seamless integration with Docker Desktop on Windows, enabling advanced
automation and interaction capabilities for developers and tools.

Prerequisites

1. Install Docker Desktop for Windows from Docker’s official download page.

2. In Docker Desktop, go to Settings > General and check the box for
   “Expose daemon on tcp://localhost:2375 without TLS”.
   This is required for the MCP server to communicate with Docker Desktop.

   💡 Tip: You can verify that the port is exposed successfully by opening
   http://localhost:2375/version in your browser. If the setup is correct,
   you should see a JSON response with Docker version information.
   If you’re having trouble, check this discussion for a possible solution:
   WSL and Docker for Windows: Cannot connect to the Docker daemon

Installation

Usage with Claude Desktop

{
  "mcpServers": {
    "docker-mcp-stdio": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "freezeolo/docker-mcp-server"
      ]
    }
  }
}

Tools

✅ Completed 🛠️ In Progress ❌ Plan

Container Lifecycle Management ✅

• list_containers - Get the list of containers ✅
• get_container_info - Get details of a specific container ✅
  • container_id: Container ID (string, required)
• start_container - Start a container ✅
  • container_id: Container ID (string, required)
• restart_container - Restart a container ✅
  • container_id: Container ID (string, required)
• stop_container - Stop a container ✅
  • container_id: Container ID (string, required)
• remove_container - Remove a container ✅
  • container_id: Container ID (string, required)
• create_container - Create a new container ✅
  • imageName: Image name (string, required)
  • containerName: Container name (string, required)
  • command: Command to run (string, optional)
  • env: Environment variables (string[], optional)
  • ports: Port bindings (string[], optional)
  • volumes: Volume bindings (string[], optional)
  • network: Network name (string, optional)
  • restartPolicy: Restart policy (string, optional)

Network Management ✅

• list_networks - List all networks ✅
• get_network_info - Get network information ✅
  • networkId: Network ID (string, required)
• create_network - Create a new network ✅
  • networkName: Network name (string, required)
  • driver: Network driver (string, required)
  • subnet: Subnet CIDR (string, required)
  • gateway: Gateway IP (string, required)
• connect_container_to_network - Connect container to network ✅
  • containerId: Container ID (string, required)
  • networkId: Network ID (string, required)
• disconnect_container_from_network - Disconnect container from network ✅
  • containerId: Container ID (string, required)
  • networkId: Network ID (string, required)
• remove_network - Remove a network ✅
  • networkId: Network ID (string, required)
• get_network_containers - Get containers in a network ✅
  • networkId: Network ID (string, required)

Image Management ✅

• list_images - List all images ✅
• pull_image - Pull an image from registry ✅
  • imageName: Image name with tag (string, required)
• push_image - Push an image to registry ✅
  • imageName: Image name with tag (string, required)
• remove_image - Remove an image ✅
  • imageId: Image ID (string, required)
  • force: Force removal (boolean, optional)
• tag_image - Tag an image with multiple tags ✅
  • imageId: Image ID (string, required)
  • repository: Repository name (string, required)
  • tags: Array of tags (string[], required)
• build_image - Build an image from Dockerfile ✅
  • dockerfilePath: Path to Dockerfile (string, required)
  • repository: Repository name (string, required)
  • tags: Array of tags (string[], required)
• get_image_details - Get image details ✅
  • imageId: Image ID (string, required)

Logs Management ✅

• get_container_logs - Get container logs ✅
  • containerId: Container ID (string, required)
  • follow: Follow log output (boolean, optional, default: false)
  • stdout: Show stdout (boolean, optional, default: true)
  • stderr: Show stderr (boolean, optional, default: true)
  • since: Show logs since timestamp (string, optional)
  • until: Show logs until timestamp (string, optional)
  • tail: Number of lines to show from the end (integer, optional)
  • timestamps: Show timestamps (boolean, optional, default: false)

FAQ

Q: How do I install the project?

A: Follow the steps in the Installation section. Make sure you have the required dependencies.

License

This project is licensed under the terms of the MIT open source license. Please refer to MIT for the full terms.