mcpcan

MCPCan is an open-source platform for managing MCP (Model Context Protocol) services with a modern web interface. It provides unified MCP service lifecycle management, multi-protocol compatibility and conversion, real-time monitoring, built-in security/authentication, and one-stop deployment. The deployment workflow is containerized to avoid host conflicts and to support Kubernetes-based environments. Users interact with MCPCan via its Web UI to monitor services, convert between MCP protocols, and deploy MCP services across environments. The system is designed for DevOps teams to centrally manage multiple MCP service instances, view status and performance, and securely control access to resources.

Once deployed, you can start/stop services, configure MCP pipelines, and leverage protocol conversion to bridge different MCP architectures. The platform supports Kubernetes deployments for scaling and provides a straightforward path to rollout via Helm charts in supported environments. Access the Web UI to manage credentials, permissions, and service configurations, and use the built-in monitoring dashboards to observe service health and throughput across your MCP landscape.

Prerequisites

• Docker and Docker Compose installed on your host (or a Kubernetes cluster for Helm deployment)
• Git for cloning repositories

Step-by-step installation (Docker Compose quick start)

1. Get deployment repository

   • For international users: git clone https://github.com/Kymo-MCP/mcpcan-deploy.git cd mcpcan-deploy/docker-compose/
   • For China users (Gitee mirror): git clone https://gitee.com/kymomcp/mcpcan-deploy.git cd mcpcan-deploy/docker-compose/

2. Prepare configuration

   • Copy example.env to .env to set environment variables (e.g., REGISTRY_PREFIX to switch mirrors)

3. Generate final configuration (as needed by the deployment) chmod +x replace.sh ./replace.sh

4. Start services (Docker Compose) docker compose up -d

5. Access the MCPCan Web UI Open http://localhost (or http://<your-public-ip>) and login with: Username: admin Password: admin123

Kubernetes/Helm deployment (if using Helm charts)

• Refer to the Helm Deployment Guide: https://kymo-mcp.github.io/mcpcan-deploy/
• Follow the Helm charts installation steps to deploy MCPCan components onto a Kubernetes cluster.

Tips and common issues:

• Ensure Docker is running before starting MCPCan services. If you encounter port conflicts, modify the .env configuration to adjust ports/interfaces used by MCPCan components.
• The REGISTRY_PREFIX environment variable can help switch between global and China mirrors when pulling images; set this in the .env file before running replace.sh.
• Access the Web UI at http://localhost or the assigned IP address; default login is admin/admin123 unless overridden by deployment configuration.
• For Kubernetes deployments, use the Helm charts described in the deployment guide and ensure your cluster has sufficient resources for the MCPCan components (Web UI, Backend, Gateway, Market, and Authz).
• This MCP server supports multi-protocol compatibility and protocol conversion; explore the UI to configure MCP pipelines and observe real-time monitoring dashboards for service health.