MCP Time Server

Servidor de tiempo MCP ( mcp-time-srv )

Un servidor de Protocolo de Contexto de Modelo (MCP) simple implementado en TypeScript que proporciona herramientas para consultas relacionadas con el tiempo, incluida la obtención de la hora actual en varias zonas horarias y la conversión de horas entre zonas horarias.

Este servidor admite los protocolos de transporte HTTP+SSE MCP heredados y HTTP Streamable modernos.

Características

Proporciona las siguientes herramientas MCP:

• get_current_time : Devuelve la hora actual en una zona horaria IANA especificada.
• convert_time : convierte una hora determinada de una zona horaria IANA de origen a una zona horaria IANA de destino.

Prerrequisitos

• Node.js (se recomienda v18 o posterior)
• npm (normalmente viene con Node.js)
• Docker (opcional, para ejecutar en un contenedor)

Configuración

1. Clona el repositorio (si aún no lo has hecho):
   # git clone <your-repo-url> # cd mcp-time-srv
2. Instalar dependencias:
   npm install

Ejecutando localmente

1. Construya el código TypeScript:
   npm run build
   Esto compila la fuente TypeScript en src/ a JavaScript en dist/ .
2. Ejecutar el servidor: puede ejecutar el servidor usando ts-node (para desarrollo) o directamente con node después de la compilación.
   • Usando ts-node :
     npx ts-node src/server.ts
   • Usando node (después de la construcción):
     node dist/server.js

El servidor se iniciará, normalmente escuchando en el puerto 3000.

Ejecutar con Docker (opcional)

Se proporciona un Dockerfile para construir y ejecutar el servidor en un contenedor.

1. Construya la imagen de Docker:
   docker build -t mcp-time-srv .
2. Ejecute el contenedor:
   docker run -d -p 3000:3000 --name my-mcp-server mcp-time-srv
   • -d : Ejecutar en modo separado (en segundo plano).
   • -p 3000:3000 : asigna el puerto 3000 de su host al puerto 3000 del contenedor.
   • --name my-mcp-server : asigna un nombre al contenedor para una administración más sencilla.

El servidor se ejecutará dentro del contenedor, accesible en http://localhost:3000 .

Para detener el contenedor:

Para ver los registros:

Pruebas con el cliente

Se incluye un script de cliente de prueba simple ( src/client.ts ) para demostrar la interacción con las herramientas del servidor.

1. Asegúrese de que el servidor esté ejecutándose (ya sea localmente o en Docker).
2. Ejecute el cliente:
   npx ts-node src/client.ts

El cliente se conectará al servidor (utilizando el transporte SSE de forma predeterminada), enumerará las herramientas disponibles, llamará a cada herramienta con argumentos de ejemplo (incluidos algunos diseñados para probar el manejo de errores) e imprimirá los resultados.

Detalles de la herramienta

get_current_time

Devuelve la hora actual en la zona horaria especificada.

• Argumento de entrada:
  • timezone (cadena, opcional): Un nombre de zona horaria de IANA (p. ej., America/New_York , Europe/London ). Si se omite, se usa la zona horaria local del servidor de forma predeterminada.
• Salida: Un objeto JSON que contiene:
  • timezone (cadena): la zona horaria efectiva utilizada.
  • datetime (cadena): la hora actual en formato ISO 8601 con desplazamiento (por ejemplo, 2025-04-26T01:39:15Z ).

convert_time

Convierte una hora de una zona horaria de origen a una zona horaria de destino.

• Argumentos de entrada:
  • source_timezone (cadena, opcional): Nombre de la zona horaria de la IANA de origen. Si se omite, el valor predeterminado es la zona horaria local del servidor.
  • time (cadena, obligatoria): la hora a convertir en formato HH de 24 horas (por ejemplo, 14:30 ).
  • target_timezone (cadena, opcional): Nombre de la zona horaria de la IANA de destino. Si se omite, el valor predeterminado es la zona horaria local del servidor.
• Salida: Un objeto JSON que contiene:
  • source (objeto): Detalles de la hora en la zona horaria de origen ( timezone , datetime ).
  • target (objeto): Detalles de la hora convertida en la zona horaria de destino ( timezone , datetime ).
  • time_difference (cadena): la diferencia entre las zonas horarias de origen y destino (por ejemplo, +8h , -5h , +5.75h ).

Licencia

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