Docker MCP Server
docker
docker pull docker.cnb.cool/masx200/docker_mirror/docker_mcp_server:latest
Building and Running with Docker
Build Docker Image
To build the Docker image locally:
Power your agent
Cài đặt từ nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
Chưa có bản phát hành đóng gói nào trong registry. Làm theo README của kho mã.
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởTừ nhà phát hành
docker pull docker.cnb.cool/masx200/docker_mirror/docker_mcp_server:latest
To build the Docker image locally:
https://github.com/makbn/docker_mcp_server
docker build -t docker-mcp-server .
After building the image, you can run it:
# Basic run
docker run -d -p 3000:3000 --name docker-mcp-server docker-mcp-server
# With Docker socket mounted (for Docker operations)
docker run -d -p 3000:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
--name docker-mcp-server docker-mcp-server
# With custom configuration
docker run -d -p 8080:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-e DOCKER_HOST=unix:///var/run/docker.sock \
--name docker-mcp-server docker-mcp-server
Once the container is running, the Docker MCP Server will be available through the HTTP bridge:
http://localhost:3000/mcp/dockerhttp://localhost:3000/ws/dockerhttp://localhost:3000/sse/dockerHere's how to configure the Docker MCP Server with Claude Desktop:
{
"mcpServers": {
"docker": {
"url": "http://localhost:3000/mcp/docker",
"transport": "streamable-http"
}
}
}
Or with WebSocket:
{
"mcpServers": {
"docker": {
"url": "ws://localhost:3000/ws/docker",
"transport": "ws"
}
}
}
For easier deployment, you can use the provided docker-compose.yml file:
# Start the service
docker-compose up -d
# Stop the service
docker-compose down
# View logs
docker-compose logs -f
This module provides an implementation of a Model Context Protocol MCP server for Docker commands, powered by the
mcp_mediator core framework.
The Docker MCP Server utilizes the automatic server generation feature of MCP Mediator to expose existing Docker
commands as MCP Tools.
Each command is optionally annotated with @McpTool along with a minimal description to enhance tool discoverability
and usability.
👉 See the full list of supported commands here.

[!IMPORTANT]
This is part ofmcp_mediatorproject: https://github.com/makbn/docker_mcp_server To build or modify, clone the parent repository:git clone --recurse-submodules https://github.com/makbn/docker_mcp_server.git
java -jar docker-mcp-server.jar \
--docker-host=tcp://localhost:2376 \
--tls-verify \
--cert-path=/etc/docker/certs \
--server-name=my-server \
--server-version=1.0.0 \
--max-connections=150 \
--docker-config=/custom/docker/config
To run Docker MCP Server with Claude Desktop with java -jar:
{
"mcpServers": {
"my_java_mcp_server": {
"command": "java",
"args": [
"-jar",
"docker-mcp-server.jar"
"--docker-host=tcp://localhost:2376",
"--tls-verify", # not required
"--cert-path=/etc/docker/certs", # required only if --tls-verify is available
"--server-name=my-docker-mcp-server",
"--server-version=1.0.0",
"--max-connections=150",
"--docker-config=/custom/docker/config"
]
}
}
}
Or create the native image (see the steps below) and use the standalone application:
{
"mcpServers": {
"my_java_mcp_server": {
"command": "docker-mcp-server-executable",
"args": [
"--docker-host=tcp://localhost:2376" // rest of args
]
}
}
}
To build the executable:
mvn clean compile package
This command creates a jar file under target folder mcp-mediator-implementation-docker-[version].jar. You can stop
here and use the jar file and execute it
using java -jar command. Or, you can create a standalone executable application using GraalVM native image:
native-image -jar mcp-mediator-implementation-docker-[version].jar
and this command creates an executable file: 'mcp-mediator-implementation-docker-[version] that can be executed.
This project integrates with MCP Mediator to automatically generate MCP Tools
from existing Docker services.
Each method in the Docker service class can optionally be annotated with @McpTool to explicitly define the tool’s *
name*, description, and other metadata.
However, annotation is not required—MCP Mediator supports automatic generation for non-annotated methods by
inferring details from the method, class, and package names. To enable this behavior, set createForNonAnnotatedMethods
to true:
DefaultMcpMediator mediator = new DefaultMcpMediator(McpMediatorConfigurationBuilder.builder()
.createDefault()
.serverName(serverName)
.serverVersion(serverVersion)
.build());
mediator.
registerHandler(McpServiceFactory.create(dockerClientService)
.
createForNonAnnotatedMethods(true)); // Enables support for non-annotated methods
Check io.github.makbn.mcp.mediator.docker.server.DockerMcpServer for the full Mcp Mediator configuration.
Environment variables:
Work in progress, more to be added.
Check the DockerClientService class for the full list of available and planned tools (to be implemented)
[!IMPORTANT]
Almost all the MCP Tools' descriptions and names are generated automatically using AI agent!
This project is a Git subtree module of the parent repository
makbn/mcp_mediator. It is kept in its own repository to support independent
versioning, CI, and release processes, while remaining integrated into the main mcp_mediator mono-repo.
If you're working in the context of the full mcp_mediator system:
`git clone --recurse-submodules https://github.com/makbn/docker_mcp_server.git`
Contributions are welcome! Please feel free to submit a Pull Request. Read this first!
This project is licensed under the GPL3 License—see the LICENSE file for details.
https://github.com/makbn/docker_mcp_server
Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Docker chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-10-28. https://github.com/makbn/docker_mcp_server