1buck MCP

Portainer MCP HTTP服务器

这只是一个包装 便携式mcp 它允许您通过HTTP客户端访问Portainer。

运作原理

┌─────────────────────────────────────────────────────────────────────────────┐
│                          YOUR INFRASTRUCTURE                                 │
│                                                                              │
│   Kontainer App                  portainer-mcp-server         Portainer     │
│   (your phone)                   (your server)                (your server) │
│                                                                              │
│   ┌─────────────┐                ┌────────────────────┐      ┌───────────┐ │
│   │             │   HTTPS/SSE    │                    │      │           │ │
│   │  Connect    │───────────────▶│  Receive requests  │─────▶│  Docker   │ │
│   │             │                │  Forward to MCP    │      │  Swarm    │ │
│   │  Control    │◀───────────────│  Return results    │◀─────│  K8s      │ │
│   │             │   Responses    │                    │      │           │ │
│   └─────────────┘                └────────────────────┘      └───────────┘ │
│                                                                              │
│   ● Your data stays on your servers                                          │
│   ● Your credentials never leave your infrastructure                         │
│   ● No third-party services involved                                         │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

数据流

1. 您运行服务器 在您的机器/Portainer旁边的VPS上
2. 应用程序连接 通过密码身份验证连接到您的服务器
3. 服务器转发 通过MCP向Portainer发出请求
4. 结果返回 直接到您的应用程序

您的Portainer API令牌和密码永远不会离开您的基础设施。

安装

选项1：自动安装脚本

# Install latest version (v0.7.0)
curl -fsSL https://raw.githubusercontent.com/1buck/portainer-mcp-http-server/main/install.sh | bash

# Install specific version
curl -fsSL https://raw.githubusercontent.com/1buck/portainer-mcp-http-server/main/install.sh | bash -s -- --version v0.7.0

# Show all options
curl -fsSL https://raw.githubusercontent.com/1buck/portainer-mcp-http-server/main/install.sh | bash -s -- --help

______________________________________________________________________

选项2：Docker（推荐）

docker run -d \
  -p 8080:8080 \
  -e PORTAINER_URL=https://portainer.example.com \
  -e PORTAINER_TOKEN=your-token \
  -e MCP_PASSWORD=your-password \
  -e MCP_BASE_URL=192.168.1.50:8080 \
  -e MCP_READ_ONLY=false \
  -e MCP_DEBUG=false \
  ghcr.io/1buck/portainer-mcp-server:latest

______________________________________________________________________

选项3：Docker Compose（推荐）

version: '3.8'
services:
  portainer-mcp-server:
    image: ghcr.io/1buck/portainer-mcp-server:latest
    ports:
      - "8080:8080"
    environment:
      - PORTAINER_URL=https://portainer.example.com
      - PORTAINER_TOKEN=your-token
      - MCP_PASSWORD=your-password
      - MCP_BASE_URL=192.168.1.50:8080
      - MCP_READ_ONLY=false
      - MCP_DEBUG=false
      - MCP_SKIP_VERSION_CHECK=false

______________________________________________________________________

选项4：从源代码构建

git clone https://github.com/1buck/portainer-mcp-http-server.git
cd portainer-mcp-http-server
go build -o portainer-mcp-server .

用法

二进制

二进制是 独立的 -它会自动提取并使用捆绑的 portainer-mcp 二进制在支持的平台上。

# Basic usage
./portainer-mcp-server \
  -portainer-url http://localhost:9000 \
  -portainer-token YOUR_TOKEN \
  -password YOUR_PASSWORD \
  -base-url 192.168.1.50:8080

# All options
./portainer-mcp-server \
  -portainer-url http://localhost:9000 \
  -portainer-token YOUR_TOKEN \
  -password YOUR_PASSWORD \
  -listen :8080 \
  -base-url 192.168.1.50:8080 \
  -mcp-path /usr/local/bin/portainer-mcp \
  -read-only false \
  -skip-version-check false \
  -debug false \
  -use-http false

二进制分辨率： 服务器将：

1. 使用捆绑的 portainer-mcp 二进制（自动提取到临时目录）
2. 返回到搜索PATH portainer-mcp 如果捆绑的二进制文件不可用
3. 如果满足以下条件，请使用显式路径 -mcp-path 提供标志

Docker/Docker编写

环境变量映射到标志：

配置

所需标志

可选标志

从Kontainer应用程序连接

1. 启动服务器
2. 在Kontainer应用程序中

- 转到实例设置屏幕 - 扫描控制台生成的二维码或手动输入网址和密码

1. 测试并保存连接

下载移动应用程序

• 安卓：https://play.google.com/store/apps/details?id=com.devculi.kontainer
• 网间网操作系统：https://apps.apple.com/us/app/portainer/id6742278087

Nginx代理配置

✅ 更新（v0.7.0）：服务器现在自动处理nginx兼容性！

服务器发送 X-Accel-Buffering: no 头和SSE心跳（间隔30s），告诉nginx：

• 自动禁用SSE流的缓冲
• 通过nginx空闲超时保持连接活动

无需更改nginx配置 对于大多数nginx代理设置。只需在nginx后面部署服务器，它就应该可以工作了。

当你仍然需要手动Nginx配置时

如果在部署v0.7.1+后仍然遇到连接问题，请将此添加到Nginx代理管理器的 高级 选项卡：

为什么需要它

SSE连接需要：

• 无缓冲 -事件必须立即流式传输，而不是批处理
• 长时间超时 -连接长时间保持打开状态
• HTTP/1.1 -分块传输编码所需

Nginx代理设置

在Nginx Proxy中，将以下内容添加到您的代理主机：

# SSE endpoint - CRITICAL for streaming
location /sse {
    proxy_pass http://YOUR_BACKEND_IP:PORT;
    
    # MUST HAVE - Disable buffering for SSE
    proxy_buffering off;
    proxy_cache off;
    proxy_max_temp_file_size 0;
    
    # MUST HAVE - HTTP/1.1 for streaming
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    
    # Standard headers
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    # MUST HAVE - Prevent timeout (24 hours)
    proxy_read_timeout 86400s;
    proxy_send_timeout 86400s;
    
    # Clean chunk handling
    chunked_transfer_encoding off;
}

# Message endpoint - normal timeout OK
location /mcp/message {
    proxy_pass http://YOUR_BACKEND_IP:PORT;
    
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    
    # Normal timeout for RPC calls
    proxy_read_timeout 60s;
    proxy_send_timeout 60s;
}

# Connect endpoint (for testing)
location /connect {
    proxy_pass http://YOUR_BACKEND_IP:PORT;
    
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

常见问题

许可证

麻省理工学院