Plantillas de servidor MCP

Plantillas de inicio de servidor MCP de nivel de producción con límites de permisos, pruebas de integración y contratos de evaluación.

Plantillas

Plantilla	Descripción	Características clave
basic	Servidor MCP mínimo	Herramientas de eco + cálculo, validación Zod
database	Acceso a base de datos de solo lectura	Validación SQL, introspección de esquema, límites de permisos
api-gateway	Proxy de API externa	Limitación de tasa, alcance de credenciales, configuración de endpoints

Inicio rápido

Clona este repositorio o usa "Use this template" en GitHub
Navega a la plantilla que desees: cd templates/basic
Instala las dependencias: pnpm install
Inicia el servidor: pnpm start

Arquitectura

Cada plantilla sigue los mismos patrones:

Motor de permisos — Reglas declarativas (permitir/denegar) evaluadas antes de cada invocación de herramienta
Cliente de prueba en memoria — Pruebas de integración a través de InMemoryTransport del SDK de MCP
Contratos de evaluación — Especificaciones de evaluación YAML compatibles con @visystems/claude-eval-runner

Utilidades compartidas

El directorio shared/ contiene utilidades reutilizables:

permissions/ — Tipos de políticas de permisos, motor y PermissionDeniedError
testing/ — Cliente de prueba MCP en memoria para pruebas de integración
errors/ — Clases de error tipadas

Desarrollo

pnpm install
pnpm typecheck    # TypeScript type checking
pnpm test         # Run all tests
pnpm test:shared  # Run shared utility tests only
pnpm test:basic   # Run basic template tests only