Poratiner Ce MCP Server

🚀 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