How mp-tool/komodo-mcp-server works
Komodo MCP Server exposes infrastructure-management tools to MCP clients. The workflow is client request → registered tool handler → authenticated Komodo API call → structured and Markdown response. The tool surface covers resource lifecycle operations, terminal and log access, Docker inspection, user API keys, updates, and TOML export. Startup, auth, connection monitoring, configuration, and shared response/security utilities form supporting layers. README supplies broader capability coverage; sampled source confirms startup, registration, client/auth behavior, and server-tool calls, but not the internal wiring of every tool.
Main entry points: client.ts Komodo client · server.ts Server tools · index.ts MCP server · komodo-identity.ts Login and identity
Components 21
MCP runtime
- MCP server
src/index.ts - Tool registration
src/tools/index.ts
Identity and connection
- Login and identity
src/auth/komodo-identity.ts - Login page
src/auth/login.ts - Komodo client
src/client.ts
Infrastructure tools
- Server tools
src/tools/server.ts - Container tools
src/tools/container.ts - Stack and deployment tools
src/tools/stack.ts - Deployment tools
src/tools/deployment.ts - Docker inspection
src/tools/docker.ts
Operations tools
- Build and repo tools
src/tools/build.ts - Automation resources
src/tools/procedure.ts - Swarm tools
src/tools/swarm.ts - Terminal and logs
src/tools/terminal.ts - Other tool categories
src/tools
Shared services
- Runtime configuration
src/config/index.ts - API and polling helpers
src/utils/api-helpers.ts - Response rendering
src/utils/markdown.ts - Error handling
src/errors/index.ts
Other components
- MCP client
- Komodo Core
Connections 21
- MCP client → MCP server: sends requests
- MCP server → Tool registration: loads tools
- MCP server → Runtime configuration: resolves settings
- MCP server → Login and identity: sets identity
- MCP server → Login page: renders login
- Login and identity → Komodo client: builds context
- Komodo client → Komodo Core: connects
- Server tools → Komodo client: uses API
- Container tools → Komodo client: uses API
- Stack and deployment tools → Komodo client: uses API
- Deployment tools → Komodo client: uses API
- Docker inspection → Komodo client: uses API
- Build and repo tools → Komodo client: uses API
- Automation resources → Komodo client: uses API
- Swarm tools → Komodo client: uses API
- Terminal and logs → Komodo client: uses API
- Other tool categories → Komodo client: uses API
- Server tools → API and polling helpers: calls helpers
- Server tools → Response rendering: renders results
- Server tools → Error handling: uses errors
- Server tools → MCP client: returns results