AI导哈

MCP服务器管理平台

一个用于发布、版本控制和在Cloudflare Workers上部署MCP服务器的集中管理系统。

  • by Kenth06
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Kenth06/mcp-manager

使用说明

MCP Control Plane

Sistema de gestión centralizada para publicar, versionar y administrar MCP Servers desplegados en Cloudflare Workers.

🏗️ Arquitectura

Este proyecto es un monorepo construido con Turborepo que incluye:

  • mcp-manager: Backend principal con Hono + Durable Objects para gestionar MCPs
  • mcp-dashboard: Frontend Next.js para administración visual
  • mcp-worker-template: Template para generar Workers MCP

📦 Estructura del Proyecto

mcp-control-plane/
├── apps/
│   ├── mcp-manager/              # Backend principal
│   ├── mcp-dashboard/            # Frontend (Next.js)
│   └── mcp-worker-template/      # Template para Workers MCP
├── scripts/
│   ├── deploy.ts                 # Script de deploy
│   └── seed-db.ts                # Script para inicializar DB
└── turbo.json                    # Configuración Turborepo

🚀 Inicio Rápido

Prerrequisitos

  • Node.js 18+
  • npm 10+
  • Cuenta de Cloudflare con Workers habilitado
  • Wrangler CLI instalado globalmente: npm install -g wrangler

Instalación

# Instalar dependencias
npm install

# Configurar variables de entorno
cd apps/mcp-manager
wrangler secret put CF_API_TOKEN
wrangler secret put CF_ACCOUNT_ID

Configuración de Cloudflare

  1. Crear base de datos D1:

    wrangler d1 create mcp-registry

  2. Crear bucket R2:

    wrangler r2 bucket create mcp-bundles

  3. Crear KV namespace (opcional):

    wrangler kv:namespace create CACHE

  4. Actualizar wrangler.jsonc con los IDs generados (en apps/mcp-manager/wrangler.jsonc)

  5. Ejecutar migraciones:

    npm run seed

Desarrollo

# Ejecutar todos los servicios en modo desarrollo
npm run dev

# Ejecutar solo el backend
cd apps/mcp-manager && npm run dev

# Ejecutar solo el frontend
cd apps/mcp-dashboard && npm run dev

Deploy

# Deploy del backend
npm run deploy

# O manualmente
cd apps/mcp-manager && wrangler deploy

📚 API Endpoints

MCPs

  • GET /api/mcp - Listar MCPs (con paginación)
  • POST /api/mcp - Crear nuevo MCP
  • GET /api/mcp/:id - Obtener MCP por ID
  • PATCH /api/mcp/:id - Actualizar MCP
  • DELETE /api/mcp/:id - Eliminar MCP (soft delete)

Versiones

  • GET /api/versions/:mcpId - Listar versiones de un MCP
  • POST /api/versions/:mcpId - Crear nueva versión
  • POST /api/versions/:mcpId/versions/:version/publish - Publicar versión

Deployments

  • GET /api/deployments - Listar deployments
  • GET /api/deployments/:id - Obtener deployment por ID
  • GET /api/deployments/:id/stream - SSE stream de progreso

🗄️ Base de Datos

El proyecto usa Cloudflare D1 (SQLite) con el siguiente schema:

  • mcp_servers: Registro de MCPs
  • mcp_versions: Versiones de cada MCP
  • deployments: Historial de deployments
  • mcp_auth_configs: Configuración de autenticación

Ver apps/mcp-manager/migrations/0001_initial.sql para el schema completo.

🔐 Seguridad

  • API Keys se hashean con SHA-256 antes de almacenar
  • OAuth tokens se validan antes de usar
  • CORS configurado estrictamente
  • Secrets nunca se exponen en logs

🧪 Testing

# Ejecutar tests del backend
cd apps/mcp-manager && npm test

# Ejecutar tests con coverage
cd apps/mcp-manager && npm test -- --coverage

📋 Características Implementadas

  • ✅ API REST completa con Hono
  • ✅ Durable Objects con WebSocket streaming
  • ✅ Dashboard Next.js con componentes UI
  • ✅ Sistema de versionado completo
  • ✅ Rollback automático
  • ✅ Tests unitarios con Vitest
  • ✅ Manejo de errores con Effect-TS
  • ✅ Configuración moderna con wrangler.jsonc

📝 Licencia

MIT

相关 MCP