Documentación

MCP Fusion/Operate and integrate/Rendimiento y escalado

Rendimiento y escalado

Pregunta a la IA sobre Vinkius

Comprende la mecánica real del rendimiento: middleware compilado, esquemas Zod en caché, mapas O(1), serialización AOT opcional, concurrencia limitada y escalado horizontal sin estado, sin benchmarks inventados.

MCP Fusion optimiza el trabajo que puede conocer antes de la solicitud y deja visible la latencia de tu base de datos y de los servicios upstream. Esta página separa los mecanismos respaldados por el código fuente de las afirmaciones de benchmarks: el repositorio no tiene una suite de benchmarks ni una cifra medida de operaciones por segundo.

Trabajo en tiempo de build

Cuando se registra un builder, el framework compila y guarda en caché:

  • el JSON Schema combinado y un esquema estricto de validación Zod por acción
  • la cadena de middleware, con el middleware global en el exterior y el middleware de acción en el interior
  • el mapa de acciones y el mapa plano de enrutamiento de exposición
  • el serializador Presenter cuando está instalado el serializador AOT opcional
  • las coincidencias de política de sincronización de estado y los resúmenes de contrato

La ruta de solicitud resuelve después los mapas e invoca closures. No crea un array de middleware, regenera un esquema ni recorre builders.

Coste cero cuando está desactivado

El código de ejecución comprueba los subsistemas opcionales antes de construir sus hooks:

  • ningún objeto de protección de concurrencia sin .concurrency()
  • ningún serializador FIFO de mutaciones salvo que una acción sea destructiva
  • ningún hook de depuración sin debug
  • ninguna rama de tracing sin tracing
  • ningún trabajo de telemetría cuando no hay clientes en el bus de telemetría
  • ningún sumidero de progreso sin un progressToken de cliente

Es una propiedad de la ruta de código, no una promesa de latencia fija.

Serialización

createSerializer() carga de forma diferida el fast-json-stringify opcional, convierte esquemas Zod a JSON Schema y guarda las funciones compiladas en un WeakMap. Si falta la dependencia o falla la compilación, usa JSON.stringify. Instala el peer opcional cuando la serialización de respuestas sea un cuello de botella medido y perfila el resultado con tus propios datos.

Descarte de carga y orden

concurrency({ maxActive, maxQueue }) es un semáforo limitado. Una cola llena devuelve SERVER_BUSY con instrucciones de recuperación en lugar de permitir un crecimiento ilimitado de memoria. Las acciones destructivas reciben un MutationSerializer FIFO por acción, así que dos escrituras en la misma acción no compiten. La cancelación elimina los waiters en cola mediante el mismo AbortSignal.

Escalado horizontal sin estado

transport: 'stateless' crea un MCP Server nuevo para cada solicitud y no tiene afinidad de sesión. Los adaptadores de Vercel y Cloudflare guardan el registro compilado en el ámbito del módulo, pero usan respuestas JSON sin SSE y sin memoria de sesión compartida. Cualquier instancia detrás de un balanceador puede procesar cualquier solicitud. El estado duradero debe estar en tu base de datos, un almacén externo o un identificador explícito de estado de solicitud, no en una variable de módulo.

Escala el contexto antes que la CPU

La mayor parte del coste de un agente está en el contexto, no en la ejecución de JavaScript. Antes de añadir infraestructura:

  1. agrupa acciones relacionadas tras un discriminador
  2. filtra la superficie por etiquetas de despliegue o rol
  3. usa .agentLimit() en colecciones
  4. expón _select para entidades amplias
  5. usa TOON para arrays y descripciones uniformes
  6. perfila la inflación de tokens en el lockfile

Consulta Token economics y Tool exposition.

Lo que no afirmamos

El repositorio del framework no contiene un directorio de benchmarks ni una tabla medida de operaciones por segundo. Afirmaciones como una serialización 2x más rápida o una reducción porcentual de costes son heurísticas de documentación, no una garantía. Mide tu handler, base de datos, upstream y forma del payload con Observability.

Opciones de despliegue

  • Deploy para la ruta Edge gestionada gratuita de Vinkius Cloud
  • Vercel mediante @mcpfusion/vercel
  • Cloudflare Workers mediante @mcpfusion/cloudflare
  • Self hosting cuando tu perímetro deba permanecer en tu cuenta

Las herramientas, los Presenters y el middleware no cambian entre estos destinos.

Próximos pasos