Komodo MCP Server
MCP server that lets AI assistants manage Komodo DevOps servers, stacks and deployments
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.9.1
- Listing updated
- today
Similar MCP servers
About Komodo MCP Server
Komodo MCP Server is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
The README describes an MCP server that connects a Komodo Core instance to AI clients such as Cursor, Claude Code and Claude Desktop, so servers, stacks, deployments and builds can be queried or acted on in plain language. It exposes 63 tools grouped into 14 categories that cover the Komodo DevOps API.
Access is controlled by a tier setting: read-only, read-execute, or full. Lower tiers hide deploy, destroy and write tools from the client entirely. Category and tool allowlists or blocklists can narrow the set further. User administration tools need a Komodo admin account regardless of tier.
The server runs over stdio via npx or Docker, or as a Streamable HTTP endpoint. The README warns that the HTTP transport has no authentication, so it should stay on loopback or behind an authenticating proxy. It is aimed at engineers who already run Komodo and want to operate it from an AI assistant.
Install
Run in a terminal
claude mcp add mcp-komodo --env KOMODO_URL='<KOMODO_URL>' --env KOMODO_API_KEY='<KOMODO_API_KEY>' --env KOMODO_API_SECRET='<KOMODO_API_SECRET>' -- npx -y @samik081/mcp-komodoAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-komodo": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-komodo"
],
"env": {
"KOMODO_URL": "<KOMODO_URL>",
"KOMODO_API_KEY": "<KOMODO_API_KEY>",
"KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-komodo": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-komodo"
],
"env": {
"KOMODO_URL": "<KOMODO_URL>",
"KOMODO_API_KEY": "<KOMODO_API_KEY>",
"KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-komodo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@samik081/mcp-komodo"
],
"env": {
"KOMODO_URL": "<KOMODO_URL>",
"KOMODO_API_KEY": "<KOMODO_API_KEY>",
"KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-komodo": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-komodo"
],
"env": {
"KOMODO_URL": "<KOMODO_URL>",
"KOMODO_API_KEY": "<KOMODO_API_KEY>",
"KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-komodo": {
"command": "npx",
"args": [
"-y",
"@samik081/mcp-komodo"
],
"env": {
"KOMODO_URL": "<KOMODO_URL>",
"KOMODO_API_KEY": "<KOMODO_API_KEY>",
"KOMODO_API_SECRET": "<KOMODO_API_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
KOMODO_URLURL of the Komodo instance (e.g. https://komodo.example.com)RequiredKOMODO_API_KEYKomodo API keyRequiredKOMODO_API_SECRETKomodo API secretRequiredKOMODO_URLURL of the Komodo instance (e.g. https://komodo.example.com)RequiredKOMODO_API_KEYKomodo API keyRequiredKOMODO_API_SECRETKomodo API secretRequired
Tools this server provides (10)
Taken from the project documentation; the running server may differ.
- komodo_list_servers
- List all servers with status and region
- komodo_get_server_stats
- Get CPU, memory, disk usage, and load averages
- komodo_list_stacks
- List all stacks with state, server, and service count
- komodo_get_stack_log
- Get logs from stack services, with optional search
- komodo_deploy_stack
- Deploy or redeploy a stack
- komodo_pull_stack
- Pull latest images without redeploying (docker compose pull)
- komodo_stack_lifecycle
- Start, stop, restart, pause, or unpause a stack; optionally targets specific services
- komodo_list_updates
- List operation history with filters for resource type, target, operation, and success
- komodo_get_update
- Get full operation details including logs with stdout/stderr for each stage
- komodo_trigger_sync
- Trigger a GitOps sync from the Git repo
What it does
- Broad Komodo API coverage
- Provides 63 tools across servers, stacks, deployments, builds, repos, procedures and more.
- Tiered access control
- Read-only, read-execute and full tiers decide which tools are registered with the client.
- Category and tool filtering
- Environment variables allow exposing only chosen categories or excluding named tools.
- Stdio and HTTP transports
- Runs as a local stdio process via npx or Docker, or as a remote HTTP MCP endpoint.
- Operation log inspection
- Lists operation history and fetches full stdout and stderr for each stage of a failed run.
- Secret redaction for env values
- Inspect tools replace container environment values with hashes unless explicitly allowed.
Good for
- Check server CPU, memory and disk usage from a chat assistant
- Review logs from a failing stack and find the cause of a failed deploy
- Redeploy or pull new images for a stack without leaving the editor
- Trigger a GitOps resource sync from a configured Git repository
- Prune unused Docker resources on a managed server
Pricing
Open source
MIT licensed, free to self-host.
Komodo MCP Server FAQ
Which Komodo version is it built for?
The README says it is built for Komodo 1.19.5.
How is access restricted?
The KOMODO_ACCESS_TIER variable sets read-only, read-execute or full. Tools outside the tier are not registered with the MCP server.
What credentials does it need?
KOMODO_URL, KOMODO_API_KEY and KOMODO_API_SECRET are required. The server validates the connection on startup.
Is the HTTP transport secured?
The README says the HTTP transport has no authentication and recommends keeping it on loopback or behind an authenticating reverse proxy.
Is Komodo MCP Server free?
Yes. Komodo MCP Server is open source, so you can use and self-host it for free.
How do I add Komodo MCP Server to Claude Code?
Run this command in your terminal: claude mcp add mcp-komodo --env KOMODO_URL='<KOMODO_URL>' --env KOMODO_API_KEY='<KOMODO_API_KEY>' --env KOMODO_API_SECRET='<KOMODO_API_SECRET>' -- npx -y @samik081/mcp-komodo
What are the best alternatives to Komodo MCP Server?
The closest alternatives to Komodo MCP Server are Proxmox VE MCP Server, mcp, MCP Server, RunCloud MCP by usefulapi and maintenant.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
