MCP Fusion/Get started/Instalación

Instalación

Pregunta a la IA sobre Vinkius

Instala @mcpfusion/core, genera tu primer servidor con la CLI y descubre qué paquetes adicionales existen para autenticación, testing y despliegue.

MCP Fusion se distribuye como el paquete npm @mcpfusion/core con un conjunto de add-ons opcionales. Todo funciona sobre Node.js 18 o superior con TypeScript 5.7 o superior.

Instala el core

bash

npm install @mcpfusion/core @modelcontextprotocol/sdk

El @modelcontextprotocol/sdk oficial es una peer dependency: MCP Fusion implementa el protocolo MCP 2.0 sobre él y se mantiene totalmente conforme a él.

Genera un servidor

bash

npx @mcpfusion/core create my-server

El scaffold hace unas preguntas y genera un proyecto funcional:

src/server.ts con initMCPFusion() listo para ejecutarse
src/tools/, donde el routing basado en archivos descubre tus tools
src/server.ts donde startServer() define el transporte y el puerto
Un contrato arquitectónico SKILL.md que los agentes de codificación con IA siguen automáticamente

¿Trabajas con un agente de codificación con IA como Cursor, Claude Code, Copilot o Windsurf? La CLI inyecta el contrato SKILL.md en .cursorrules, .windsurfrules y .clinerules por ti. Así el agente escribe código estilo MVA sin que se lo pidas. Consulta Skills.

Ejecútalo en local

bash

mcpfusion dev --server ./src/server.ts

mcpfusion dev arranca el servidor con hot reload. Conecta un cliente para probarlo de inmediato:

bash

claude mcp add my-server npx tsx src/server.ts

Paquetes adicionales

Cada add-on es un paquete npm independiente bajo el scope @mcpfusion. Instala solo lo que necesites.

Paquete	Qué añade
`@mcpfusion/yaml`	Tools sin código escritas en YAML
`@mcpfusion/jwt`	Verificación JWT con HS256, RS256 y JWKS
`@mcpfusion/oauth`	OAuth 2.0 Device Authorization Grant
`@mcpfusion/api-key`	Validación de API keys resistente a ataques de temporización
`@mcpfusion/skills`	Divulgación progresiva de `SKILL.md`
`@mcpfusion/testing`	Harness de pruebas en memoria para todo el pipeline
`@mcpfusion/vercel`	Despliega el mismo servidor en Vercel
`@mcpfusion/cloudflare`	Despliega el mismo servidor en Cloudflare Workers
`@mcpfusion/aws`	Convierte funciones Lambda y Step Functions en tools
`@mcpfusion/openapi-gen`	Genera Models, Views y Agents desde specs de OpenAPI
`@mcpfusion/prisma-gen`	Genera tools y Presenters desde un schema de Prisma

bash

npm install @mcpfusion/jwt

Opciones del servidor

No hay un archivo de configuración aparte: la entrada del servidor llama a startServer() con un objeto de opciones normal. El transport es stdio (por defecto), http (Streamable HTTP con sesiones, con opciones de puerto, TTL, rate limit y CORS) o stateless (MCP 2.0: un servidor nuevo por petición, sin handshake, cualquier balanceador atiende cualquier llamada).

Próximos pasos

Quickstart: construye y conecta una primera tool
Deploy: pon tu conector en Vinkius Cloud gratis
CLI: cada comando de mcpfusion explicado