Plantilla simple de TypeScript de MCP

Una plantilla sencilla de TypeScript para crear servidores de Protocolo de Contexto de Modelo (MCP). Este proyecto proporciona una base para crear herramientas MCP personalizadas que se pueden integrar con sistemas de IA.

Descripción general

Esta plantilla implementa un servidor MCP básico con una herramienta de cálculo de IMC de ejemplo. Demuestra cómo:

• Configurar un servidor MCP en TypeScript

• Definir e implementar herramientas MCP con validación de entrada utilizando Zod

• Conecte el servidor a la E/S estándar para la comunicación

Related MCP server: MCP Server Python Template

Prerrequisitos

• Node.js (se recomienda v20 o superior)

• npm o hilo

Instalación

1. Clonar este repositorio

2. Instalar dependencias:

npm install

Estructura del proyecto

• index.ts - Implementación del servidor principal con herramienta de ejemplo

• package.json - Dependencias y scripts del proyecto

• tsconfig.json - Configuración de TypeScript

Uso

Construyendo y funcionando

Construya e inicie el servidor:

npm start

Esto compilará el código TypeScript e iniciará el servidor MCP.

Desarrollo

Para el desarrollo, puedes:

1. Modifique index.ts para agregar sus propias herramientas

2. Ejecute el comando de compilación para compilar:

npm run build

Creación de herramientas personalizadas

Para crear una nueva herramienta, siga este patrón en index.ts :

server.tool(
  "your-tool-name",
  {
    // Define input schema using Zod
    paramName: z.string(),
    // Add more parameters as needed
  },
  async ({ paramName }) => ({
    content: [{
      type: "text",
      text: "Your tool's response"
    }]
  })
);

Dependencias

• @modelcontextprotocol/sdk - SDK principal de MCP

• zod - Validación de esquemas

• dotenv - Gestión de variables de entorno

• typescript - compilador de TypeScript

Licencia

ISC

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.