Hello World MCP Server

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.

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:

2. Instalar dependencias

Instale las dependencias necesarias usando npm o yarn:

o

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:

Esto generará los archivos compilados en el directorio dist .

5. Ejecute el servidor

Inicie el servidor en modo de producción:

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

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:

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:

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:

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.