docker-mcp
A docker MCP Server (modelcontextprotocol)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/quantgeekdev--docker-mcp)HTML
<a href="/listings/quantgeekdev--docker-mcp"><img src="/api/listings/quantgeekdev--docker-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
To try this in Claude Desktop app, add this to your claude config files:
{
"mcpServers": {
"docker-mcp": {
"command": "uvx",
"args": [
"docker-mcp"
]
}
}
}Installing via Smithery
To install Docker MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/docker-mcp):
npx @smithery/cli install docker-mcp --client claude
Prerequisites
- UV (package manager) - Python 3.12+ - Docker Desktop or Docker Engine - Claude Desktop
Installation
Claude Desktop Configuration
Add the server configuration to your Claude Desktop config file:
**MacOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
<details> <summary>π» Development Configuration</summary>
{
"mcpServers": {
"docker-mcp": {
"command": "uv",
"args": [
"--directory",
"<path-to-docker-mcp>",
"run",
"docker-mcp"
]
}
}
}</details>
<details> <summary>π Production Configuration</summary>
{
"mcpServers": {
"docker-mcp": {
"command": "uvx",
"args": [
"docker-mcp"
]
}
}
}</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 206 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # π³ docker-mcp
- [](https://www.python.org/downloads/release/python-3120/)
- [](https://opensource.org/licenses/MIT)
- [](https://github.com/psf/black)
- [](https://smithery.ai/protocol/docker-mcp)
- A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.
- ## β¨ Features
- - π Container creation and instantiation
- - π¦ Docker Compose stack deployment
- - π Container logs retrieval
- - π Container listing and status monitoring
- ### π¬ Demos
- #### Deploying a Docker Compose Stack
- https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278
- #### Analyzing Container Logs
- https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934
- ## π Quickstart
- To try this in Claude Desktop app, add this to your claude config files:
- ```json
- {
- "mcpServers": {
- "docker-mcp": {
- "command": "uvx",
- "args": [
- "docker-mcp"
- ]
- }
- }
- }
- ```
- ### Installing via Smithery
- To install Docker MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/docker-mcp):
- ```bash
- npx @smithery/cli install docker-mcp --client claude
- ```
- ### Prerequisites
- - UV (package manager)
- - Python 3.12+
- - Docker Desktop or Docker Engine
- - Claude Desktop
- ### Installation
- #### Claude Desktop Configuration
- Add the server configuration to your Claude Desktop config file:
- **MacOS**: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
- <details>
- <summary>π» Development Configuration</summary>
- ```json
- {
- "mcpServers": {
- "docker-mcp": {
- "command": "uv",
- "args": [
- "--directory",
- "<path-to-docker-mcp>",
- "run",
- "docker-mcp"
- ]
- }
- }
- }
- ```
- </details>
- <details>
- <summary>π Production Configuration</summary>
- ```json
- {
- "mcpServers": {
- "docker-mcp": {
- "command": "uvx",
- "args": [
- "docker-mcp"
- ]
- }
- }
- }
- ```
- </details>
- ## π οΈ Development
- ### Local Setup
- 1. Clone the repository:
- ```bash
- git clone https://github.com/QuantGeekDev/docker-mcp.git
- cd docker-mcp
- ```
- 2. Create and activate a virtual environment:
- ```bash
- python -m venv venv
- source venv/bin/activate # On Windows: venv\Scripts\activate
- ```
- 3. Install dependencies:
- ```bash
- uv sync
- ```
- ### π Debugging
- Launch the MCP Inspector for debugging:
- ```bash
- npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp
- ```
- The Inspector will provide a URL to access the debugging interface.
- ## π Available Tools
- The server provides the following tools:
- ### create-container
- Creates a standalone Docker container
- ```json
- {
- "image": "image-name",
- "name": "container-name",
- "ports": {"80": "80"},
- "environment": {"ENV_VAR": "value"}
- }
- ```
- ### deploy-compose
- Deploys a Docker Compose stack
- ```json
- {
- "project_name": "example-stack",
- "compose_yaml": "version: '3.8'\nservices:\n service1:\n image: image1:latest\n ports:\n - '8080:80'"
- }
- ```
- ### get-logs
- Retrieves logs from a specific container
- ```json
- {
- "container_name": "my-container"
- }
- ```
- ### list-containers
- Lists all Docker containers
- ```json
- {}
- ```
- ## π§ Current Limitations
- - No built-in environment variable support for containers
- - No volume management
- - No network management
- - No container health checks
- - No container restart policies
- - No container resource limits
- ## π€ Contributing
- 1. Fork the repository from [docker-mcp](https://github.com/QuantGeekDev/docker-mcp)
- 2. Create your feature branch
- 3. Commit your changes
- 4. Push to the branch
- 5. Open a Pull Request
- ## π License
- This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
- ## β¨ Authors
- - **Alex Andru** - *Initial work | Core contributor* - [@QuantGeekDev](https://github.com/QuantGeekDev)
- - **Ali Sadykov** - *Initial work | Core contributor* - [@md-archive](https://github.com/md-archive)
- ---
- Made with β€οΈ
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.