Servidor Lambda MCP

Un paquete Node.js que proporciona infraestructura de servidor MCP (Protocolo de contexto de modelo) para funciones de AWS Lambda con soporte SSE.

Características

• Adapta el SDK TypeScript de MCP para que funcione con AWS Lambda

• Admite eventos enviados por el servidor (SSE) a través de la transmisión de respuestas Lambda

• Maneja la validación de métodos CORS y HTTP

• Compatibilidad con TypeScript

Related MCP server: Example MCP SSE Server

Notas importantes

• La transmisión de respuestas Lambda solo funciona con URL de función . No funciona con API Gateway ni con Application Load Balancer.

• Sólo el entorno de ejecución de Node.js es oficialmente compatible con la transmisión de respuestas.

Instalación

npm install @markvp/mcp-lambda-layer

Uso

Crea tu función Lambda e importa el paquete:

import { MCPHandlerFactory } from '@markvp/mcp-lambda-layer';
import { z } from 'zod';

// Create MCP handler factory with your configuration
const factory = new MCPHandlerFactory({
  tools: {
    summarize: {
      params: {
        text: z.string(),
      },
      handler: async ({ text }) => {
        // Your implementation here - could be any service/model/API
        const summary = await yourSummarizeImplementation(text);
        return {
          content: [{ type: 'text', text: summary }],
        };
      },
    },
  },
  prompts: {
    generate: {
      description: 'Generate content based on a prompt',
      handler: async extra => {
        // Your implementation here - could be any service/model/API
        const result = await yourGenerateImplementation(extra.prompt);
        return {
          content: [{ type: 'text', text: result }],
        };
      },
    },
  },
});

// Export the handler directly
export const handler = factory.getHandler();

Configuración Lambda requerida

• Tiempo de ejecución: Node.js 18.x o posterior

• Manejador: index.handler

• Memoria: 128 MB mínimo (ajuste según sus necesidades)

• Tiempo de espera: se recomiendan 120 segundos

• URL de función: Obligatoria y debe tener habilitada la transmisión de respuestas

• API Gateway/ALB: no compatible con streaming

Contenido del paquete

Este paquete proporciona:

• Implementación del servidor MCP con transporte SSE

• Manejo de protocolos (JSON-RPC)

• Soporte de respuesta en streaming

• Definiciones de tipos e interfaces

Su función Lambda proporciona:

• Implementaciones de herramientas y avisos

• Lógica de negocios

• Cualquier cliente o servicio API necesario

• Configuración

Licencia

Instituto Tecnológico de Massachusetts (MIT)