Servidor MCP Hola Mundo

¡Bienvenido al servidor MCP "Hola Mundo" ! Este proyecto muestra cómo configurar un servidor usando el SDK del Protocolo de Contexto de Modelo (MCP) . Incluye herramientas, indicaciones y puntos finales para gestionar eventos y mensajes enviados por el servidor (SSE).

Este proyecto forma parte de la entrada del blog: Creación de un servidor MCP de TypeScript: Guía para la integración de servicios existentes . Visite el blog para obtener más información sobre los conceptos y los detalles de implementación de este proyecto.

Características

• Integración con MCP : utiliza el SDK de MCP para crear un servidor con herramientas y avisos.

• Express Framework : maneja puntos finales HTTP para SSE y comunicación de mensajes.

• Configuración del entorno : utiliza archivos .env para una fácil configuración.

• Compatibilidad con TypeScript : base de código completamente tipificada para una mejor experiencia del desarrollador.

Related MCP server: Skemati.ca MCP SSE Server

Prerrequisitos

Antes de comenzar, asegúrese de tener instalado lo siguiente:

1. Node.js (v16 o superior) - Descargar aquí

2. npm (viene con Node.js) o yarn

Empezando

Siga estos pasos para configurar y ejecutar el proyecto:

1. Clonar el repositorio

Si aún no lo ha hecho, clone el repositorio en su máquina local:

git clone https://github.com/your-username/hello-world-mcp-server.git
cd hello-world-mcp-server

2. Instalar dependencias

Instale las dependencias necesarias usando npm o yarn:

npm install

o

yarn install

3. Configurar variables de entorno

El proyecto utiliza un archivo .env para configurar el puerto del servidor. Se proporciona un archivo .env.example de ejemplo.

1. Copie el archivo .env.example a .env :

   cp .env.example .env

2. Abra el archivo .env y actualice la variable PORT si es necesario. El valor predeterminado es 4000 .

   PORT=4000

4. Construir el proyecto

Compilar el código TypeScript en JavaScript:

npm run build

Esto generará los archivos compilados en el directorio dist .

5. Ejecute el servidor

Inicie el servidor en modo de producción:

npm start

Alternativamente, para el modo de desarrollo con recarga en vivo, use:

npm run dev

Probando el servidor

1. Uso del inspector MCP

El Inspector MCP es una herramienta para probar e inspeccionar su servidor MCP. Puede usarlo para verificar que sus herramientas y avisos estén registrados correctamente.

Ejecute el siguiente comando para inspeccionar su servidor:

npx @modelcontextprotocol/inspector ./dist/server.js

Esto abrirá una interfaz interactiva donde podrá probar las herramientas y los mensajes registrados en su servidor como se muestra a continuación.

Estructura del proyecto

A continuación se muestra una descripción general de la estructura del proyecto:

hello-world-mcp-server/
├── src/
│   ├── server.ts                     # Main server entry point
│   ├── modules/
│   │   ├── tools.ts                  # Registers MCP tools
│   │   ├── prompts.ts                # Registers MCP prompts
│   │   └── transports.ts             # Handles SSE and message endpoints
├── .env                              # Environment variables
├── .env.example                      # Example environment variables
├── package.json                      # Project metadata and scripts
├── tsconfig.json                     # TypeScript configuration
└── README.md                         # Project documentation

Solución de problemas

Problemas comunes

1. Puerto ya en uso : si ve un error sobre el puerto que está en uso, actualice la variable PORT en el archivo .env .

2. Errores de TypeScript : asegúrese de haber instalado todas las dependencias y de estar utilizando la versión correcta de Node.js.

Depuración

Utilice el siguiente comando para depurar el servidor:

npm run dev

Esto iniciará el servidor con recarga en vivo y registros detallados.

Proyectos relacionados

• Proyecto Pydantic de Ollama : Un contraproyecto que implementa un agente LLM que utiliza las herramientas desarrolladas en este proyecto. Más información en la entrada del blog: Integración del servidor MCP con un chatbot LLM local .

Contribuyendo

¡Agradecemos sus contribuciones! No dude en abrir problemas o enviar solicitudes de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.