Docker MCP

1# 🐳 docker-mcp
2 
3[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)
4[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
6[![smithery badge](https://smithery.ai/badge/docker-mcp)](https://smithery.ai/protocol/docker-mcp)
7 
8A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.
9 
10## ✨ Features
11 
12- 🚀 Container creation and instantiation
13- 📦 Docker Compose stack deployment
14- 🔍 Container logs retrieval
15- 📊 Container listing and status monitoring
16 
17### 🎬 Demos
18#### Deploying a Docker Compose Stack
19 
20 
21https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278
22 
23 
24 
25#### Analyzing Container Logs
26 
27 
28 
29https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934
30 
31 
32 
33## 🚀 Quickstart
34 
35To try this in Claude Desktop app, add this to your claude config files:
36```json
37{
38  "mcpServers": {
39    "docker-mcp": {
40      "command": "uvx",
41      "args": [
42        "docker-mcp"
43      ]
44    }
45  }
46}
47```
48 
49### Installing via Smithery
50 
51To install Docker MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/docker-mcp):
52 
53```bash
54npx @smithery/cli install docker-mcp --client claude
55```
56 
57### Prerequisites
58 
59- UV (package manager)
60- Python 3.12+
61- Docker Desktop or Docker Engine
62- Claude Desktop
63 
64### Installation
65 
66#### Claude Desktop Configuration
67 
68Add the server configuration to your Claude Desktop config file:
69 
70**MacOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json`  
71**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
72 
73<details>
74  <summary>💻 Development Configuration</summary>
75 
76```json
77{
78  "mcpServers": {
79    "docker-mcp": {
80      "command": "uv",
81      "args": [
82        "--directory",
83        "<path-to-docker-mcp>",
84        "run",
85        "docker-mcp"
86      ]
87    }
88  }
89}
90```
91</details>
92 
93<details>
94  <summary>🚀 Production Configuration</summary>
95 
96```json
97{
98  "mcpServers": {
99    "docker-mcp": {
100      "command": "uvx",
101      "args": [
102        "docker-mcp"
103      ]
104    }
105  }
106}
107```
108</details>
109 
110## 🛠️ Development
111 
112### Local Setup
113 
1141. Clone the repository:
115```bash
116git clone https://github.com/QuantGeekDev/docker-mcp.git
117cd docker-mcp
118```
119 
1202. Create and activate a virtual environment:
121```bash
122python -m venv venv
123source venv/bin/activate  # On Windows: venv\Scripts\activate
124```
125 
1263. Install dependencies:
127```bash
128uv sync
129```
130 
131### 🔍 Debugging
132 
133Launch the MCP Inspector for debugging:
134 
135```bash
136npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp
137```
138 
139The Inspector will provide a URL to access the debugging interface.
140 
141## 📝 Available Tools
142 
143The server provides the following tools:
144 
145### create-container
146Creates a standalone Docker container
147```json
148{
149    "image": "image-name",
150    "name": "container-name",
151    "ports": {"80": "80"},
152    "environment": {"ENV_VAR": "value"}
153}
154```
155 
156### deploy-compose
157Deploys a Docker Compose stack
158```json
159{
160    "project_name": "example-stack",
161    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
162}
163```
164 
165### get-logs
166Retrieves logs from a specific container
167```json
168{
169    "container_name": "my-container"
170}
171```
172 
173### list-containers
174Lists all Docker containers
175```json
176{}
177```
178 
179## 🚧 Current Limitations
180 
181- No built-in environment variable support for containers
182- No volume management
183- No network management
184- No container health checks
185- No container restart policies
186- No container resource limits
187 
188## 🤝 Contributing
189 
1901. Fork the repository from [docker-mcp](https://github.com/QuantGeekDev/docker-mcp)
1912. Create your feature branch
1923. Commit your changes
1934. Push to the branch
1945. Open a Pull Request
195 
196## 📜 License
197 
198This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
199 
200## ✨ Authors
201 
202- **Alex Andru** - *Initial work | Core contributor* - [@QuantGeekDev](https://github.com/QuantGeekDev)
203- **Ali Sadykov** - *Initial work  | Core contributor* - [@md-archive](https://github.com/md-archive)
204 
205---
206Made with ❤️
207