xmcp: framework declarativo en TypeScript para construir servidores MCP rápidamenteNota · digest del 27 de octubre
Bodegón minimalista estilo Knolling que muestra la estructura de archivos del framework declarativo en TypeScript xmcp para servidores MCP.
Nota3 secciones≈ 4 min

xmcp: framework declarativo en TypeScript para construir servidores MCP rápidamente

El protocolo Model Context Protocol (MCP), propuesto por los creadores de Claude, se ha convertido en tiempo récord en el estándar de la industria para conectar herramientas externas a agentes de IA. Pero si has intentado escribir tu propio servidor MCP desde cero con el SDK oficial de bajo nivel @modelcontextprotocol/sdk, seguro que sentiste un ligero bajón.

En lugar de centrarte en la lógica útil de la herramienta (consultar la base de datos, llamar a una API, leer un archivo), te ves obligado a escribir kilobytes de pegamento de infraestructura: configurar a mano canales de entrada/salida (stdio o Server-Sent Events), registrar handlers del ciclo de vida, transformar errores manualmente y ensamblar esquemas JSON.

Todo ese trabajo pesado lo asume xmcp, un elegante framework declarativo en TypeScript del estudio basementstudio (el código fuente está abierto en su repositorio de GitHub).

Paradigma «una herramienta es un archivo»: enrutamiento por archivos para agentes

Los creadores de xmcp han trasladado al mundo MCP la misma idea que hizo tan populares a Next.js y Astro: el enrutamiento basado en sistema de archivos (File System Routing).

En lugar de un único archivo server.ts inflado donde se amontonan decenas de funciones, simplemente creas una carpeta tools/. Cada archivo dentro de esa carpeta se convierte automáticamente en una herramienta aislada para la IA:

my-mcp-server/
├── tools/
│   ├── check-balance.ts
│   ├── send-notification.ts
│   └── query-database.ts
├── xmcp.config.ts
└── package.json

El runtime de xmcp escanea el directorio, registra automáticamente las herramientas en el protocolo, valida los parámetros entrantes y genera el manifiesto de capacidades.

Cómo se escribe una herramienta: validación estricta con Zod

Dentro del archivo de la herramienta exportas la función declarativa defineTool:

// tools/create-invoice.ts
import { defineTool } from 'xmcp';
import { z } from 'zod';

export default defineTool({
  name: 'create_invoice',
  description: 'Crea una factura de cobro para un cliente en el sistema contable',
  parameters: z.object({
    clientEmail: z.string().email().describe('Correo electrónico del destinatario de la factura'),
    amount: z.number().positive().describe('Importe de la factura en rublos'),
    currency: z.enum(['RUB', 'USD', 'EUR']).default('RUB'),
  }),
  async execute({ clientEmail, amount, currency }) {
    // ¡Toda la validación ya la ha hecho el runtime!
    const invoice = await billingService.create({ clientEmail, amount, currency });
    
    return {
      status: 'success',
      invoiceId: invoice.id,
      paymentUrl: invoice.url,
    };
  },
});

Fíjate en cómo desaparece todo el boilerplate: el tipado de los argumentos en el método execute se infiere automáticamente del esquema parameters. Si el agente pasa un email inválido o un importe negativo, xmcp intercepta el fallo antes de tocar la lógica de negocio y devuelve al LLM un mensaje claro de error de validación.

Transportes de serie y modo de desarrollo rápido

El framework se encarga de todos los detalles de comunicación de bajo nivel:

  • Doble transporte: el servidor funciona tanto mediante flujos estándar stdio (para conexión local con Claude Desktop o Cursor) como sobre el protocolo Server-Sent Events (SSE) por HTTP para alojamiento remoto en la nube.
  • Recarga en caliente (Hot Reload): el comando npx xmcp dev arranca un servidor local que actualiza las herramientas al instante al guardar un archivo; ya no hace falta reiniciar el proceso a mano tras cada retoque en un prompt o esquema.
# Arrancar el servidor en modo desarrollo vigilando cambios
npx xmcp dev

# Compilar el bundle optimizado listo para producción
npx xmcp build

Si ya utilizas herramientas de terminal para IA, échale un vistazo a nuestro artículo sobre plugins para Claude Code e interceptación de comandos peligrosos. Y con la llegada de xmcp, la barrera para levantar tus propios servidores MCP escalables se ha reducido literalmente a cinco minutos.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 3