Plantilla estándar del servidor MCP

Una implementación de servidor estándar para el Protocolo de Contexto de Modelo (MCP), creado con TypeScript y Express.

Tabla de contenido

Descripción general
Estructura del proyecto
Empezando
Ejecución del servidor
- Servidor HTTP
- Modo estudio
Recursos
Herramientas
Indicaciones
Ampliación del servidor
Pruebas y depuración
Licencia

Descripción general

Este proyecto implementa un servidor que sigue el Protocolo de Contexto de Modelo (MCP), lo que permite a las aplicaciones proporcionar contexto para LLM de forma estandarizada. Incluye:

Un servidor MCP completamente configurado con opciones de transporte HTTP y stdio
Recursos de muestra, herramientas y sugerencias para demostrar la funcionalidad clave
Compatibilidad con TypeScript para seguridad de tipos y una mejor experiencia para el desarrollador
Integración expresa para la capa de transporte HTTP

Estructura del proyecto

mcp-server-boilerplate/
├── .env                  # Environment variables
├── .env.example          # Example environment variables
├── .gitignore            # Git ignore file
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── src/
│   ├── index.ts          # Main HTTP server entry point
│   ├── stdio.ts          # Stdio server entry point
│   ├── resources/        # MCP resources
│   │   ├── index.ts      # Resource registration
│   │   ├── infoResource.ts # Static info resource
│   │   └── greetingResource.ts # Dynamic greeting resource
│   ├── tools/            # MCP tools
│   │   ├── index.ts      # Tool registration
│   │   ├── calculatorTool.ts # Sample calculator tool
│   │   └── timestampTool.ts # Sample timestamp tool
│   └── prompts/          # MCP prompts
│       ├── index.ts      # Prompt registration
│       ├── greetingPrompt.ts # Sample greeting prompt
│       └── analyzeDataPrompt.ts # Sample data analysis prompt
└── dist/                 # Compiled JavaScript output

Empezando

Prerrequisitos

Node.js (v18 o posterior)
npm o hilo

Instalación

Clonar el repositorio e instalar las dependencias:

git clone https://github.com/yourusername/mcp-server-boilerplate.git
cd mcp-server-boilerplate
npm install

Variables de entorno

Copie el archivo de entorno de ejemplo y modifíquelo según sea necesario:

cp .env.example .env

Variables de entorno disponibles:

PORT : El puerto para el servidor HTTP (predeterminado: 3000)
NODE_ENV : Modo de entorno (desarrollo, producción)
Configuración de OAuth (si es necesario)

Ejecución del servidor

Servidor HTTP

Construya e inicie el servidor HTTP:

npm run build
npm start

Para desarrollo con reinicio automático:

npm run dev

El servidor estará disponible en http://localhost:3000/mcp (o el puerto especificado en su archivo .env).

Modo estudio

Para ejecutar el servidor en modo stdio (para herramientas de línea de comandos):

npm run start:stdio

Para desarrollo con reinicio automático:

npm run dev:stdio

Recursos

El texto estándar incluye estos recursos de ejemplo:

Recurso de información estática : info://server
- Proporciona información básica sobre el servidor.
Recurso de saludo dinámico : greeting://{name}
- Genera un saludo personalizado con el parámetro de nombre proporcionado

Para acceder a los recursos:

A través del protocolo MCP
Uso de una biblioteca de cliente MCP

Herramientas

El código estándar incluye estas herramientas de ejemplo:

Calculadora : Realiza operaciones aritméticas básicas
- Parámetros:
  - operation : Operación a realizar (sumar, restar, multiplicar, dividir)
  - a : Primer número
  - b : Segundo número
Marca de tiempo : proporciona la hora actual en varios formatos
- Parámetros:
  - format : Formato de salida (iso, unix, legible)

Indicaciones

El texto estándar incluye estos ejemplos:

Saludo : crea un mensaje de saludo personalizado
- Parámetros:
  - name : Nombre para saludar
  - formal : si se debe utilizar el estilo de saludo formal (opcional)
Analizar datos : crea una solicitud para el análisis de datos
- Parámetros:
  - data : Los datos a analizar
  - format : Formato de datos (json, csv, texto)
  - instructions : Instrucciones de análisis adicionales (opcional)

Ampliación del servidor

Añadiendo recursos

Para agregar un nuevo recurso:

Crea un nuevo archivo en src/resources/ (por ejemplo, myResource.ts )
Implemente su controlador de recursos
Regístrelo en src/resources/index.ts

Ejemplo:

// myResource.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

export function myResource(server: McpServer): void {
  server.resource('my-resource', 'my-resource://path', async uri => ({
    contents: [
      {
        uri: uri.href,
        text: 'My resource content',
      },
    ],
  }));
}

// Then add to resources/index.ts
import { myResource } from './myResource.js';

export function registerResources(server: McpServer): void {
  // ...existing resources
  myResource(server);
}

Agregar herramientas

Para agregar una nueva herramienta:

Crea un nuevo archivo en src/tools/ (por ejemplo, myTool.ts )
Implemente su controlador de herramientas
Regístrelo en src/tools/index.ts

Ejemplo:

// myTool.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';

export function myTool(server: McpServer): void {
  server.tool('my-tool', { param: z.string() }, async ({ param }) => ({
    content: [
      {
        type: 'text',
        text: `Processed: ${param}`,
      },
    ],
  }));
}

// Then add to tools/index.ts
import { myTool } from './myTool.js';

export function registerTools(server: McpServer): void {
  // ...existing tools
  myTool(server);
}

Agregar indicaciones

Para agregar un nuevo mensaje:

Crea un nuevo archivo en src/prompts/ (por ejemplo, myPrompt.ts )
Implemente su controlador de indicaciones
Regístrelo en src/prompts/index.ts

Ejemplo:

// myPrompt.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';

export function myPrompt(server: McpServer): void {
  server.prompt('my-prompt', { topic: z.string() }, ({ topic }) => ({
    messages: [
      {
        role: 'user',
        content: {
          type: 'text',
          text: `Please explain ${topic} in simple terms.`,
        },
      },
    ],
  }));
}

// Then add to prompts/index.ts
import { myPrompt } from './myPrompt.js';

export function registerPrompts(server: McpServer): void {
  // ...existing prompts
  myPrompt(server);
}

Pruebas y depuración

Para probar su servidor MCP, puede utilizar:

La herramienta Inspector de MCP
Bibliotecas de cliente MCP
Solicitudes HTTP directas (para depuración)

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

MCP Server Boilerplate

Integrations