Poratiner Ce MCP Server

🚀 Portainer MCP Server

A Model Context Protocol (MCP) server implementation for Portainer, enabling AI assistants to interact with Docker containers and services via Portainer's API.

✨ Features

• Docker container management (create, start, delete, get logs)
• Docker image management (fetch, delete unused, clear build cache)
• Docker network operations (inspect, fetch)
• Docker service management (fetch, get logs)
• Container resource limit management

📁 Project Structure

portainer-ce-mcp/
├── src/
│   ├── api/
│   │   └── portainer.ts      # Portainer API integration
│   ├── constants/
│   │   └── index.ts          # Tool names and other constants
│   ├── types/
│   │   └── index.ts          # TypeScript type definitions
│   └── main.ts               # Main server implementation
├── package.json              # Project dependencies
├── package-lock.json         # Dependency lock file
├── deno.json                 # Deno configuration
└── README.md                 # Project documentation

📋 Prerequisites

• Deno
• A Portainer instance with API access
• Docker installed and running

📦 Installation

1. Clone the repository:

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

⚙️ Configuration

The server requires the following environment variables:

• PORTAINER_URL: The URL of your Portainer instance
• PORTAINER_API_KEY: Your Portainer API key
• PORTAINER_ENV_ID: Your Portainer environment ID

🛠️ API Tools

The server provides the following tools for AI assistants:

Container Management

• FETCH_DOCKER_CONTAINERS: List all containers
• CREATE_DOCKER_CONTAINER: Create a new container
• START_DOCKER_CONTAINER: Start a container
• DELETE_DOCKER_CONTAINER: Delete a container
• FETCH_CONTAINER_LOGS: Get container logs
• UPDATE_CONTAINER_RESOURCE_LIMITS: Update container resource limits
• DELETE_STOPPED_CONTAINERS: Clean up stopped containers

Image Management

• FETCH_IMAGES: List all images
• DELETE_IMAGE_BUILD_CACHE: Clear the build cache
• DELETE_UNUSED_IMAGES: Delete unused images

Network Operations

• FETCH_NETWORKS: List all networks
• INSPECT_NETWORK: Get detailed network information

Service Management

• FETCH_SERVICES: List all services
• FETCH_SERVICE_LOG: Get service logs

🛠️ Development

Build

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

Check the MCP Server

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