portainer-mcp
Provides tools for interacting with Portainer API, enabling management of Docker containers, stacks, environments, and other resources through the Portainer platform.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@portainer-mcplist all my Docker containers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lauredmarin/portainer-mcp-amd64'
If you have feedback or need assistance with the MCP directory API, please join our Discord server