Which integrations are available for this server?

Enables management of Docker Compose stacks, providing tools to list configurations and retrieve detailed stack information for containerized infrastructure. Facilitates repository management by providing tools to list connected repositories, pull the latest updates, and clone repositories for build and deployment workflows.

How do I use Komodo MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Komodo MCP Server Deploy the latest version of the API to the production cluster" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Komodo MCP Server

Model Context Protocol (MCP) server for Komodo - enabling natural language infrastructure management through Claude.

Control your servers, deployments, builds, and infrastructure using conversational AI instead of complex API calls.

Features

60+ MCP tools across 6 modules
Natural language server management
Automated deployment workflows
Real-time monitoring and alerts
Build pipeline integration
HMAC-based secure authentication
Automatic retry logic
Type-safe TypeScript implementation

Quick Start

Installation

# Clone the repository git clone https://github.com/your-org/komodo-mcp.git cd komodo-mcp # Install dependencies npm install # Build the server npm run build

Configuration

Create a .env file with your Komodo credentials:

KOMODO_URL=https://your-komodo-instance.com KOMODO_API_KEY=your-api-key KOMODO_API_SECRET=your-api-secret

Add to Claude

Claude Desktop

Add to your Claude Desktop configuration:

{ "mcpServers": { "komodo": { "command": "node", "args": ["C:/absolute/path/to/komodo-mcp/dist/index.js"], "env": { "KOMODO_URL": "https://your-komodo-instance.com", "KOMODO_API_KEY": "your-api-key", "KOMODO_API_SECRET": "your-api-secret" } } } }

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code (CLI)

claude mcp add komodo -- node /absolute/path/to/komodo-mcp/dist/index.js

Then set environment variables in your shell profile.

First Commands

Ask Claude to interact with your Komodo infrastructure:

"Show me all my servers" "Deploy my API to production" "What critical alerts do I have?" "Restart the database server" "Build version 2.5.0 and deploy to staging"

Available Tools

Read Module (16 tools)

Read-only access to all Komodo resources:

Servers

komodo_read_ListServers - List all servers with filtering
komodo_read_GetServer - Get detailed server information

Deployments

komodo_read_ListDeployments - List deployments
komodo_read_GetDeployment - Get deployment details

Stacks

komodo_read_ListStacks - List Docker Compose stacks
komodo_read_GetStack - Get stack configuration

Builds

komodo_read_ListBuilds - List build configurations
komodo_read_GetBuild - Get build details and history

Repositories

komodo_read_ListRepos - List connected repositories
komodo_read_GetRepo - Get repository information

Procedures

komodo_read_ListProcedures - List automation procedures
komodo_read_GetProcedure - Get procedure details

Actions

komodo_read_ListActions - List configured actions
komodo_read_GetAction - Get action configuration

Alerts

komodo_read_ListAlerts - List system alerts
komodo_read_GetAlert - Get detailed alert information

Execute Module (9 tools)

Trigger actions and manage infrastructure:

Deployments

komodo_execute_Deploy - Execute a deployment

Builds

komodo_execute_Build - Trigger a build process

Server Lifecycle

komodo_execute_StartServer - Start a server
komodo_execute_StopServer - Stop a server
komodo_execute_RestartServer - Restart a server

Procedures

komodo_execute_RunProcedure - Execute a procedure

Actions

komodo_execute_TriggerAction - Trigger an action

Repository Operations

komodo_execute_PullRepo - Pull latest repository changes
komodo_execute_CloneRepo - Clone a repository

Usage Examples

Server Management

User: Check the health of all production servers Claude: [Lists all servers with status, CPU, memory metrics] [Highlights any issues or alerts] [Suggests actions if needed] User: Restart the database server Claude: [Executes restart] [Monitors status] [Confirms healthy state]

Deployment Workflow

User: Deploy version 2.5.0 to staging then production Claude: [Triggers build for v2.5.0] [Deploys to staging] [Runs health checks] [Waits for approval] [Deploys to production] [Verifies all instances]

Monitoring

User: Give me a complete infrastructure health report Claude: [Analyzes all servers] [Checks all deployments] [Reviews active alerts] [Generates comprehensive report] [Recommends actions]

See EXAMPLES.md for more real-world scenarios.

Documentation

User Guides

Usage Guide - Complete usage guide with examples
API Reference - Detailed API documentation for all 60 tools
Examples - Real-world usage scenarios
Troubleshooting - Common issues and solutions
Migration Guide - Migrate from direct API usage

Technical Documentation

Architecture - System architecture and design
API Mapping - Komodo API to MCP tool mapping
Environment - Environment variable configuration

Development

Requirements

Node.js 20+
TypeScript 5+
npm 9+

Build

npm run build # Build for production npm run dev # Build and watch for changes npm run clean # Clean build artifacts

Testing

npm test # Run all tests npm run test:watch # Run tests in watch mode npm run test:coverage # Generate coverage report

Linting & Formatting

npm run lint # Check code style npm run lint:fix # Fix code style issues npm run format # Format code with Prettier npm run format:check # Check code formatting npm run typecheck # TypeScript type checking

Environment Variables

Required

Variable	Description	Example
`KOMODO_URL`	Komodo API base URL	`https://komodo.example.com`
`KOMODO_API_KEY`	API key for authentication	`km_key_abc123...`
`KOMODO_API_SECRET`	API secret for HMAC signing	`km_secret_xyz789...`

Optional

Variable	Description	Default
`KOMODO_TIMEOUT`	Request timeout (ms)	`30000`
`KOMODO_RETRY_COUNT`	Number of retries on failure	`3`
`KOMODO_RETRY_DELAY`	Delay between retries (ms)	`1000`
`KOMODO_LOG_LEVEL`	Logging level	`info`
`KOMODO_SSL_VERIFY`	Verify SSL certificates	`true`

See ENVIRONMENT.md for complete configuration details.

License

MIT License - see LICENSE file for details.

Support

Documentation: docs/
Issues: GitHub Issues
Discussions: GitHub Discussions
Komodo: github.com/mbecker20/komodo

Acknowledgments

Komodo - Infrastructure automation platform
Model Context Protocol - MCP specification
Anthropic - Claude AI assistant

Built with ❤️ for the Komodo community

Start managing your infrastructure naturally - no more complex API calls, just conversation with Claude.

Get started: Quick Start | Documentation | Examples

Komodo MCP Server

Komodo MCP Server

Features

Quick Start

Installation

Configuration

Add to Claude

Claude Desktop

Claude Code (CLI)

First Commands

Available Tools

Read Module (16 tools)

Execute Module (9 tools)

Usage Examples

Server Management

Deployment Workflow

Monitoring

Documentation

User Guides

Technical Documentation

Development

Requirements

Build

Testing

Linting & Formatting

Environment Variables

Required

Optional

License

Support

Acknowledgments

Resources

New MCP Servers

Latest Blog Posts

MCP directory API