[!CAUTION]
⚠️ v1.x is End-of-Life — Major Architecture Upgrade Notice

v2.x is a complete rewrite of v1.x with breaking architectural changes. The v1.x series has fundamental design flaws (global gateway single-point-of-failure, standalone init service, dual-image strategy) and is end-of-life — no PRs, Issues, or security patches will be accepted.

Key breaking changes: Global mcp-gateway → per-instance Traefik Sidecar | mcp-init retired, init merged into mcp-market | Dual-image → single image with CODE_MODE runtime switch | Helm chart renamed mcpcan-deploy → mcpcan | In-place upgrades are NOT supported — full reinstall required

📋 View full v2.1 Release Notes · 📦 v2.x Migration Guide

MCP CAN

The open source integration platform for MCP Server.

MCPCAN uses containers for flexible deployment of MCP services, resolving potential system configuration conflicts. It supports multi-protocol compatibility and conversion, enabling seamless integration between different MCP service architectures. It also provides visual monitoring, security authentication, and one-stop deployment capabilities.

English | 中文版
 DemoSite : demo.mcpcan.com（login: admin/admin123） | MainSite : www.mcpcan.com
Document

MCPCan is an open-source platform focused on efficient management of MCP (Model Context Protocol) services, providing DevOps and development teams with comprehensive MCP service lifecycle management capabilities through a modern web interface.
MCPCan supports multi-protocol compatibility and conversion, enabling seamless integration between different MCP service architectures while providing visual monitoring, security authentication, and one-stop deployment capabilities.

💡 Introduction

✨ Core Features

🎯 Unified Management: Centralized management of all MCP service instances and configurations
🔄 Protocol Conversion: Supports seamless conversion between various MCP protocols
📊 Real-time Monitoring: Provides detailed service status and performance monitoring data
🔐 Security Authentication: Built-in identity authentication and permission management system
🚀 One-stop Deployment: Quick release, configuration, and distribution of MCP services
📈 Scalability: Cloud-native architecture based on Kubernetes

✨ Demo and Official Website

For the best demo experience, try directly DemoSite : demo.mcpcan.com（login: admin/admin123）.

Watch our demo video on Bilibili: BV1htBXBbECr

To view our official website address, simply click MainSite : www.mcpcan.com.

👨‍🚀 Quick Start

For detailed deployment instructions, please refer to our Deployment Guide.

1. Get Deployment Repository

# Recommended: GitHub
git clone https://github.com/Kymo-MCP/mcpcan.git
cd mcpcan/deploy/docker-compose/

2. Start Services

Docker Compose Quick Start (Recommended)

Suitable for local development, testing, and lightweight production deployments.

# 1. Initialize configuration
cp example.env .env
# (Optional) Modify .env file for settings like REGISTRY_PREFIX to switch between global/CN mirrors

# 2. Generate final configuration
chmod +x replace.sh
./replace.sh

# 3. Start services
docker compose up -d

# 4. Access Web UI
Login: admin/admin123

After successful installation, access http://localhost (or http://<Your Public IP>) to start using.

Helm Installation

Suitable for Kubernetes environment deployment, please refer to Helm Deployment Guide.

🚀 Components

MCPCan adopts a microservices architecture, consisting of the following core components:

Component Name	Directory Path	Functional Description
MCPCan-Web	`frontend/`	Management UI based on Vue 3
MCP-Market	`backend/cmd/market/`	Core business: Marketplace & Instance management
MCP-Authz	`backend/cmd/authz/`	RBAC, User & Dept management

🐧 Technology Stack

🐧 Frontend

Framework: Vue 3.5.x (Composition API)
Build Tool: Vite 7.0
UI Components: Element Plus
State Management: Pinia 3.0
Styling: UnoCSS, SCSS
Editor: Monaco Editor, Markdown-it

🐧 Backend

Language: Go 1.25.x
Web Framework: Gin, gRPC (grpc-gateway)
Data Storage: MySQL (GORM), Redis (Cache/Token)
Core Libraries: LangChainGo, MCP-Go, Docker SDK, Client-go
Ops & Deployment: Traefik (Edge Gateway), Docker Compose, Helm (Kubernetes)

🐧 Related Projects

MCPCan Helm Charts - Official Helm charts index for MCPCan
Deployment Guide - Detailed deployment and configuration guide

💝 Contributing Guide

Welcome to submit PR to contribute! Please refer to Contributing for detailed guidelines.

Before contributing, please ensure:

Read our Code of Conduct
Check existing issues and pull requests (avoid duplicate work)
Follow our coding standards and commit message conventions

✅ Security

If you discover a security vulnerability, please refer to our Security Policy for responsible disclosure guidelines.

📄 License

Licensed under the Sustainable Use License. Portions of this software (specifically Enterprise features in .ee folders) are subject to the Enterprise License (LICENSE_EE.md).

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

👥 Community & Support

📖 Documentation
💬 Discord Community
🐛 Issue Tracker
📧 Mailing List
🌐 WeChat

💕 Acknowledgments

Thanks to the MCP Protocol community
Thanks to all contributors and supporters
Special thanks to the open-source projects that make MCPCan possible

mcpcan