Portainer MCP

What it does

This MCP server bridges AI models with your Portainer instance, allowing for full-scale Docker orchestration. You can inspect environments, view logs, manage container lifecycles, and deploy new Docker Compose stacks without leaving your chat interface.

Tools

• list_containers: List all containers in a specific environment.
• container_logs: Retrieve real-time logs from a container.
• create_stack: Deploy a new Docker Compose stack from a YAML definition.
• container_action: Start, stop, restart, or remove containers.
• list_environments: Discover all connected Portainer Docker endpoints.
• manage_image: Pull or remove Docker images.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "portainer": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "PORTAINER_URL=https://your-portainer-url.com",
        "-e", "PORTAINER_API_KEY=your_api_key",
        "-e", "PORTAINER_WRITE_ENABLED=true",
        "ghcr.io/caffeineflo/portainer-mcp:latest"
      ]
    }
  }
}

Supported hosts

• claude