portainer-mcp
Provides tools for interacting with Portainer API, enabling management of Docker containers, stacks, environments, and other resources through the Portainer platform.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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_TOKENOption 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_TOKENRelated 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,tarNode.js + npm (for PM2)
uv(installed automatically byinstall.shif 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 startupConfiguration (.env)
Variable | Required | Default | Description |
| β | β | Portainer URL (e.g. |
| β | β | Portainer API token |
| β |
| Port exposed by mcp-proxy |
| β |
| Path to binary |
| β | β | 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>/mcpMCP 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
Original portainer-mcp: https://github.com/portainer/portainer-mcp
NPM Package: https://www.npmjs.com/package/@lauredmarin/portainer-mcp (when published)
Issues: https://github.com/Lauredmarin/portainer-mcp-amd64/issues
π License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
Manage your own cloud with AI: deploy apps, push and ship custom Docker images, manage resources via your AI agent.
Inspect and control your Northflank projects, services, jobs, and builds from your AI assistant.
Search 600+ Docker/Portainer app templates and prepare a local deploy plan.
Deploy services, add databases, run agents, read logs, check vulnerabilities and publish pages.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables natural language interaction with Docker commands and operations. Supports container management, image operations, system information, and Docker Compose through conversational requests.141MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityDmaintenanceEnables 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.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.1MIT