Skip to main content
Glama
Lauredmarin

portainer-mcp

by Lauredmarin
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

portainer-mcp — npm wrapper for npx

Deploy portainer-mcp via npx — no manual download, no PM2, just works across platforms.

This package is also a wrapper that auto-downloads the correct binary for your platform (Linux, macOS, Windows) on install.

🚀 Usage via npx (Recommended)

Option 1: Direct npx (no install)

npx @lauredmarin/portainer-mcp -server https://portainer.example.com -token YOUR_TOKEN

Option 2: MCP Client Config (like Claude, Cursor, etc.)

{
  "mcpServers": {
    "portainer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--package=@lauredmarin/portainer-mcp",
        "portainer-mcp",
        "-server", "https://portainer.example.com",
        "-token", "YOUR_TOKEN"
      ]
    }
  }
}

Option 3: Global install

npm install -g @lauredmarin/portainer-mcp
portainer-mcp -server https://portainer.example.com -token YOUR_TOKEN

Related MCP server: Docker MCP Server

🐳 Legacy: Server deployment via mcp-proxy + PM2

For exposing as HTTP endpoint on a VPS:

Requirements

  • Linux x86-64 (amd64)

  • curl, tar

  • Node.js + npm (for PM2)

  • uv (installed automatically by install.sh if missing)

Quick start

git clone https://github.com/Lauredmarin/portainer-mcp-amd64.git
cd portainer-mcp-amd64
bash install.sh
cp .env.example .env   # fill in your values
pm2 start ecosystem.config.js
pm2 save && pm2 startup

Configuration (.env)

Variable

Required

Default

Description

PORTAINER_SERVER

✅

—

Portainer URL (e.g. https://portainer.example.com)

PORTAINER_TOKEN

✅

—

Portainer API token

MCP_PORT

❌

8749

Port exposed by mcp-proxy

PORTAINER_MCP_BIN

❌

~/portainer-mcp/portainer-mcp

Path to binary

TOOLS_YAML

❌

—

Path to a tools.yaml to restrict tools

MCP endpoint (HTTP mode)

Once running, the server is available at:

http://<your-vps-ip>:<MCP_PORT>/mcp

MCP client config:

{
  "mcpServers": {
    "portainer": {
      "type": "http",
      "url": "http://<your-vps-ip>:8749/mcp"
    }
  }
}

📦 Supported Platforms

Platform

Architecture

Status

Linux

amd64, arm64, arm

✅

macOS

amd64 (Intel), arm64 (Apple Silicon)

✅

Windows

amd64, arm64

✅

🛠️ Development

git clone https://github.com/Lauredmarin/portainer-mcp-amd64.git
cd portainer-mcp-amd64
npm install
npm run postinstall  # Downloads binary
node run.js -help

🔗 Links

📄 License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • Docker MCP Server

    pnmice
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language management of Docker containers, images, networks, and volumes with support for both local and remote Docker engines. Features automated container composition, debugging capabilities, and persistent data management through an intuitive conversational interface.
    GPL 3.0

  • Docker Manager MCP

    jmagar
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Docker containers, deploy stacks, and monitor services across multiple Docker hosts from one centralized location. Supports container lifecycle management, Docker Compose operations, and infrastructure orchestration through natural language commands.
    6
    MIT

  • Portainer MCP Server

    caffeineflo
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Docker containers, stacks, images, volumes, and networks through Portainer's API. Supports listing resources, viewing logs, and performing container operations with configurable write permissions.
    1
    -