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