MCP server for the Komodo build/deploy platform. Exposes 7 tools that map to Komodo's full RPC API surface — list, get, create, update, delete, execute, and logs — via the Model Context Protocol.

Setup

Prerequisites

Node.js 22+
A running Komodo instance with API access

Environment Variables

Variable	Required	Default	Description
`KOMODO_BASE_URL`	Yes	`http://10.10.2.114:9120`	Base URL of your Komodo instance
`KOMODO_USERNAME`	Yes	—	Komodo login username
`KOMODO_PASSWORD`	Yes	—	Komodo login password
`PORT`	No	`9800`	Port for the HTTP/SSE transport

KOMODO_URL is accepted as a legacy alias for KOMODO_BASE_URL.

Install & Build

npm install
npm run build

Run

npm start

Or for development with live reload:

npm run dev

The server starts on http://0.0.0.0:9800/mcp with a health check at /health.

MCP Client Configuration

Add to your MCP client config (e.g. mcp.json or equivalent):

{
  "mcpServers": {
    "komodo": {
      "url": "http://localhost:9800/mcp"
    }
  }
}

Tools

`komodo_list`

List or search Komodo resources.

Parameter	Type	Required	Description
`resource_type`	enum	Yes	Resource type (see below)
`search`	string	No	Search query — uses Search* endpoint instead of List*
`project`	string	No	Filter by project name or ID

Returns a JSON array of matching resources.

`komodo_get`

Get a single resource by ID or name.

Parameter	Type	Required	Description
`resource_type`	enum	Yes	Resource type
`id`	string	Yes	Resource ID or name

`komodo_create`

Create a new resource.

Parameter	Type	Required	Description
`resource_type`	enum	Yes	Resource type
`params`	object	No	Fields for the corresponding Create* endpoint

Available for: stack, build, server, procedure, deployment, alerter, image_registry_account, sync_resource, tag.

`komodo_update`

Update an existing resource by ID.

Parameter	Type	Required	Description
`resource_type`	enum	Yes	Resource type
`id`	string	Yes	Resource ID or name
`params`	object	No	Fields to update

`komodo_delete`

Delete a resource by ID or name.

Parameter	Type	Required	Description
`resource_type`	enum	Yes	Resource type
`id`	string	Yes	Resource ID or name

Available for: stack, build, server, procedure, deployment, alerter, sync_resource, tag.

`komodo_execute`

Execute a Komodo operation (build, deploy, procedure run, server actions, etc.).

Parameter	Type	Required	Description
`operation`	enum	Yes	Operation to run (see below)
`id`	string	No	Resource ID or name
`params`	object	No	Additional operation parameters

Operations:

Operation	Description
`run_build`	Trigger a build
`deploy_stack`	Deploy a stack
`deploy_stack_service`	Deploy a single stack service
`run_procedure`	Run a procedure
`run_procedure_stage`	Run a specific procedure stage
`run_deployment_action`	Run a deployment action
`run_deployment_sync`	Sync a deployment
`run_resource_sync`	Run a resource sync
`run_stack_refresh_cache`	Refresh stack cache
`run_stack_refresh_content`	Refresh stack content
`run_stack_pull`	Pull stack (git pull)
`run_stack_pull_deployment`	Pull and deploy stack
`run_stack_stop`	Stop a stack
`run_stack_restart`	Restart a stack
`run_stack_pause`	Pause a stack
`run_stack_unpause`	Unpause a stack
`run_stack_remove_orphan_containers`	Remove orphan containers
`run_stack_toggle_service_dependencies`	Toggle service dependencies
`run_stack_auto_update`	Trigger auto-update
`run_stack_commit`	Commit stack changes
`run_server_refresh`	Refresh server state
`run_server_refresh_containers`	Refresh server containers
`run_server_update_periphery`	Update periphery
`run_server_prune_images`	Prune server images
`run_server_prune_containers`	Prune server containers
`run_server_prune_networks`	Prune server networks
`run_server_stats`	Get server stats
`run_server_run_command`	Run a command on server
`run_server_scripts`	Run server scripts
`run_server_copy`	Copy between servers
`run_server_move`	Move between servers
`run_deployment_execute`	Execute a deployment
`run_deployment_redeploy`	Redeploy a deployment
`run_deployment_destroy`	Destroy a deployment
`run_deployment_stop`	Stop a deployment
`run_deployment_logs`	Get deployment logs via execute
`run_sync_deployment`	Sync a deployment
`get_mcp_token`	Get an MCP token

`komodo_logs`

Get logs for a deployment or stack.

Parameter	Type	Required	Description
`resource_type`	enum	Yes	`deployment` or `stack`
`id`	string	Yes	Resource ID or name
`tail`	number	No	Number of recent log lines

Resource Types

All tools that accept resource_type support these values:

Value	Komodo Resource
`stack`	Docker Compose stacks
`build`	Build configurations
`server`	Managed servers
`procedure`	Automation procedures
`deployment`	Deployments
`alerter`	Alert configurations
`image_registry_account`	Container registry accounts
`sync_resource`	Sync resources
`user`	Users
`tag`	Tags
`execution`	Execution history
`access_request`	Access requests

Architecture

Transport: HTTP/SSE via StreamableHTTPServerTransport (MCP protocol)
Auth: JWT login via POST /auth/login, token cached in memory, auto-refreshed on 401
API: Komodo RPC-style — all calls are POST /{read|write|execute}/{RequestName}
No REST paths: The server does not use REST-style paths (/servers, /api/servers) which serve SPA HTML

License

Private — BuzzbeeSCD