Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/quantgeekdev--docker-mcp/badge.svg)](/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

i

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)

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.