Poratiner Ce MCP Server

🚀 Portainer MCP 服務器

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 clone https://github.com/BirajMainali/poratiner-ce-mcp-server.git
cd portainer-ce-mcp

🛠️ 配置

服務器需要以下環境變量：

• PORTAINER_URL：你的 Portainer 實例 URL
• PORTAINER_API_KEY：你的 Portainer API 密鑰
• PORTAINER_ENV_ID：你的 Portainer 環境 ID

📚 詳細文檔

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-env --allow-read --allow-net --env-file=.env src/main.ts

檢查 MCP 服務器

npx @modelcontextprotocol/inspector deno run --allow-env --allow-read --allow-net --env-file=.env