Ben
0ecf6880a1
All checks were successful
Build and Push Komodo MCP Docker Image / build (push) Successful in 2m24s
Komodo MCP Server
A Model Context Protocol (MCP) server for Komodo Docker management.
Features
- Curated Tools: High-level tools for common operations
- Raw API Access: Pass-through tool for 100% API coverage
- API Docs Resource: Built-in reference for AI agents
Tools
| Tool | Description |
|---|---|
list_servers |
Lists all periphery servers |
list_deployments |
Lists deployments (containers) |
list_stacks |
Lists stacks (docker-compose) |
get_container_status |
Gets container details |
komodo_api_call |
Raw API pass-through |
Resources
| Resource | Description |
|---|---|
komodo://api-reference |
API documentation |
Configuration
Environment Variables
| Variable | Required | Description |
|---|---|---|
KOMODO_URL |
Yes | Komodo Core URL |
KOMODO_API_KEY |
Yes | API key |
KOMODO_API_SECRET |
Yes | API secret |
MCP_ALLOWED_HOSTS |
No | Allowed Host headers |
Deploy with Docker Compose
services:
komodo-mcp:
image: gitea.ext.ben.io/b3nw/komodo-mcp:latest
environment:
- KOMODO_URL=https://komodo.example.com
- KOMODO_API_KEY=your-key
- KOMODO_API_SECRET=your-secret
- MCP_ALLOWED_HOSTS=komodo-mcp.example.io,localhost:*
ports:
- "8000:8000"
Connect MCP Client
SSE endpoint: https://your-host/sse
Local Development
# Setup
cp .env.example .env
# Edit .env with your credentials
# Build and run
make build
make dev
# Test
make logs
make test-sse
make stop
Tech Stack
- Python 3.11+ / FastMCP / httpx
- SSE transport / uvicorn
- Docker with multi-stage build