Skip to main content
Glama
enesjakozh

MCP Server Boilerplate

by cds-id
GitHub
TypeScript
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Plantilla estándar del servidor MCP

Versión NPM del SDK TypeScript de MCP Licencia MIT

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

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:

  1. Recurso de información estática : info://server

    • Proporciona información básica sobre el servidor.

  2. 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:

  1. 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

  2. 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:

  1. Saludo : crea un mensaje de saludo personalizado

    • Parámetros:

      • name : Nombre para saludar

      • formal : si se debe utilizar el estilo de saludo formal (opcional)

  2. 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:

  1. Crea un nuevo archivo en src/resources/ (por ejemplo, myResource.ts )

  2. Implemente su controlador de recursos

  3. 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:

  1. Crea un nuevo archivo en src/tools/ (por ejemplo, myTool.ts )

  2. Implemente su controlador de herramientas

  3. 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:

  1. Crea un nuevo archivo en src/prompts/ (por ejemplo, myPrompt.ts )

  2. Implemente su controlador de indicaciones

  3. 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.

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Una implementación de inicio lista para usar del servidor de Protocolo de contexto de modelo (MCP) que permite que las aplicaciones proporcionen un contexto estandarizado para LLM con recursos de muestra, herramientas y avisos.

  1. Tabla de contenido
    1. Descripción general
      1. Estructura del proyecto
        1. Empezando
          1. Prerrequisitos
          2. Instalación
          3. Variables de entorno
        2. Ejecución del servidor
          1. Servidor HTTP
          2. Modo estudio
        3. Recursos
          1. Herramientas
            1. Indicaciones
              1. Ampliación del servidor
                1. Añadiendo recursos
                2. Agregar herramientas
                3. Agregar indicaciones
              2. Pruebas y depuración
                1. Licencia

                  Related MCP Servers

                  • MCP-Guide

                    qpd-v
                    A
                    security
                    A
                    license
                    A
                    quality
                    A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
                    Last updated -
                    3
                    16
                    63
                    Apache 2.0

                  • MCP Server Example

                    alejandro-ao
                    A
                    security
                    A
                    license
                    A
                    quality
                    An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.
                    Last updated -
                    1
                    135
                    MIT License
                    • Apple
                    • Linux

                  • @lex-tools/codebase-context-dumperofficial

                    lex-tools
                    A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol (MCP) server designed to easily dump your codebase context into Large Language Models (LLMs).
                    Last updated -
                    1
                    24
                    2
                    Apache 2.0

                  • MCP Server Sample

                    antonioscapellato
                    -
                    security
                    A
                    license
                    -
                    quality
                    An educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server integrating with various LLM clients.
                    Last updated -
                    2
                    MIT License

                  View all related MCP servers

                  New MCP Servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/cds-id/mcp-server-boilerplate'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server