Portainer MCP 服务器

Portainer 的模型上下文协议 (MCP) 服务器实现，使 AI 助手能够通过 Portainer 的 API 与 Docker 容器和服务进行交互。

功能

• Docker 容器管理（创建、启动、删除、获取日志）
• Docker 镜像管理（获取、删除未使用的镜像、清除构建缓存）
• Docker 网络操作（检查、获取）
• Docker 服务管理（获取、日志）
• 容器的资源限制管理

项目结构

portainer-ce-mcp/
├── src/
│   ├── api/
│   │   └── portainer.ts      # Portainer API 集成
│   ├── constants/
│   │   └── index.ts          # 工具名称和其他常量
│   ├── types/
│   │   └── index.ts          # TypeScript 类型定义
│   └── main.ts               # 主要服务器实现
├── package.json              # 项目依赖
├── package-lock.json         # 依赖锁定文件
├── deno.json                 # Deno 配置
└── README.md                 # 项目文档

前提条件

• Deno
• 具有 API 访问权限的 Portainer 实例
• 已安装并运行的 Docker

安装

1. 克隆存储库：

git https://github.com/BirajMainali/poratiner-ce-mcp-server.git
cd portainer-ce-mcp

配置

服务器需要以下环境变量：

• PORTAINER_URL: 您的 Portainer 实例的 URL
• PORTAINER_API_KEY: 您的 Portainer API 密钥

API 工具

服务器为 AI 助手提供以下工具：

容器管理

• FETCH_DOCKER_CONTAINERS: 列出所有容器
• CREATE_DOCKER_CONTAINER: 创建一个新容器
• START_DOCKER_CONTAINER: 启动一个容器
• DELETE_DOCKER_CONTAINER: 删除一个容器
• FETCH_CONTAINER_LOGS: 获取容器日志
• UPDATE_CONTAINER_RESOURCE_LIMITS: 更新容器资源
• DELETE_STOPPED_CONTAINERS: 清理已停止的容器

镜像管理

• FETCH_IMAGES: 列出所有镜像
• DELETE_IMAGE_BUILD_CACHE: 清除构建缓存
• DELETE_UNUSED_IMAGES: 删除未使用的镜像

网络操作

• FETCH_NETWORKS: 列出所有网络
• INSPECT_NETWORK: 获取网络详细信息

服务管理

• FETCH_SERVICES: 列出所有服务
• FETCH_SERVICE_LOG: 获取服务日志

开发

构建

deno compile --allow-net --allow-env --allow-read src/main.ts

MCP 配置

{
  "mcpServers": {
    "poratiner": {
      "command": "C:\\MCP\\portainer-ce-mcp\\src.exe", // 使用可执行文件路径
      "args": [
        "y"
      ]
    }
  }
}

许可证

MIT

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request