mcp-registry/portainer-mcp

    ==================
      
       /// MCP ///
      /// POR ///
        
    ==================
        
    [server:online]
    [protocol:ready]

portainer-mcp

by portainer

Go-based Model Context Protocol (MCP) server that lets AI agents manage and query Portainer (Docker/Kubernetes) environments via a standardised tool interface.

48
10
Open Source
GitHubWebsiteTwitter

Installation

1. Prerequisites
• Go 1.22 or later installed and in PATH
• Git client
• (Optional) Docker Engine if you prefer running MCP as a container
2. Clone the repository
git clone https://github.com/portainer/portainer-mcp.git cd portainer-mcp
3. Build the binary (local execution)
go build -o mcp ./cmd/portainer-mcp
4. Provide basic configuration (examples)
# The MCP server expects a YAML/JSON config or env-vars. Common values: export MCP_LISTEN_ADDR=0.0.0.0:9000 # REST / gRPC listen address export MCP_DATA_PATH=/var/lib/portainer/mcp # …add any cloud-provider tokens or TLS cert paths as needed
5. Run
./mcp --config ./mcp.yaml # or rely on environment variables
6. Containerised option
docker build -t portainer-mcp . docker run -d --name mcp -p 9000:9000 -v mcp-data:/data portainer-mcp
7. Verify
curl http://localhost:9000/healthz # should return 200 OK

Documentation

License: zlib License
Updated 7/30/2025