广告合作
MCP.so
登录

Portainer MCP Server

@portainer

代码仓库主页

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

portainer

关于 Portainer MCP Server

Official Portainer MCP server

Portainer MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "portainer-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "--name",
        "portainer-mcp",
        "-p",
        "17717:17717",
        "\\"
      ]
    }
  }
}

Portainer MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Portainer MCP?

Portainer MCP is the official MCP server for Portainer, generated from the Portainer OpenAPI spec via FastMCP. It exposes the Portainer REST API as MCP tools to list and inspect environments, manage GitOps workflows, and troubleshoot Docker and Kubernetes resources, and also supports proxying requests to the underlying Docker and K8s APIs of each environment.

How to use Portainer MCP?

Portainer MCP can be deployed locally via uvx (stdio), installed as a self-contained MCP bundle, or deployed as a container for team use. You need a Portainer URL and an API key (generated under My Account → Access tokens). For a local test, register with Claude Code using claude mcp add portainer -e PORTAINER_URL=... -e PORTAINER_API_KEY=... -- uvx --from "mcp-portainer~=2.43.0" mcp-portainer. The container deployment requires a shared gate token (PORTAINER_MCP_AUTH_TOKEN) and each user forwards their own Portainer API key.

Key features of Portainer MCP

  • Exposes Portainer REST API as MCP tools
  • List, inspect, and manage environments
  • Manage GitOps workflows
  • Troubleshoot Docker and Kubernetes resources
  • Proxy to underlying Docker and K8s APIs
  • Multiple deployment modes: local, bundle, container
  • Supports capability profiles to restrict or expand tools
  • Environment variable redaction enabled by default
  • Gate token authentication for team container deployment
  • Version must match Portainer instance minor version

Use cases of Portainer MCP

  • Inspect and manage Portainer environments from an AI assistant
  • Automate GitOps workflows on Portainer-managed Docker/K8s clusters
  • Troubleshoot containerized and Kubernetes workloads via MCP tools
  • Proxy AI-driven requests to the Docker or K8s API of a specific environment

常见问题

1

What version of Portainer is compatible with Portainer MCP?

The MCP server’s minor version must match your Portainer instance’s minor version. For example, MCP server 2.43.x works with Portainer 2.43.x.

2

How do I obtain an API key for Portainer MCP?

Generate an API key in Portainer under **My Account → Access tokens** before using either the local or container deployment.

3

Can I restrict which tools are available in Portainer MCP?

Yes. Portainer MCP supports capability profiles to enable only a subset of tools, such as read-only mode or disabling proxy capabilities. See `docs/profiles.md` for details.

4

What transport and authentication options does the container deployment support?

The container supports BYO TLS certificates, TLS-terminated reverse proxy, or plaintext HTTP (not recommended for production). It uses a shared gate token (`PORTAINER_MCP_AUTH_TOKEN`) for admission and each user forwards their own Portainer API key for authorization.

5

Is it safe to expose Portainer MCP on the public internet?

No. It is not recommended to expose this MCP server on the public internet; host it inside your private infrastructure, even behind a TLS proxy.

评论

其他 分类下的更多 MCP 服务器

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

广告合作