Date-time Tools

Un servidor para la manipulación de fecha-hora y conversión de zonas horarias.

GitHub

Documentación

Date-time Tools MCP

Un servidor de Model Context Protocol (MCP) para manipulación de fecha-hora y conversión de zona horaria.

Resumen

Este servidor MCP proporciona un conjunto de herramientas para trabajar con cadenas de fecha-hora, incluyendo conversión de zona horaria, mutación de fecha (aritmética) y obtención de la fecha-hora y zona horaria actuales. Está diseñado para usarse como utilidad de backend para aplicaciones o agentes que necesiten operaciones de fecha-hora robustas y estandarizadas.

Despliegue en vivo: https://date-time-tools.iabhishek.workers.dev/mcp

Arquitectura

Este servidor se ejecuta en Cloudflare Workers y utiliza el transporte Streamable HTTP (con un endpoint SSE heredado también expuesto). El estado por sesión está respaldado por un Durable Object mediante el envoltorio agents McpAgent de Cloudflare.

Endpoints:

  • POST/GET/DELETE /mcp — Transporte HTTP Streamable. Las sesiones se rastrean mediante el encabezado mcp-session-id.
  • GET /sse, POST /sse/message — Transporte SSE heredado para clientes antiguos.

Desarrollo local

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

Despliegue en Cloudflare

Manual

Configuración única:

npx wrangler login

Desplegar:

npm run deploy

Wrangler imprime la URL pública — para este proyecto es https://date-time-tools.iabhishek.workers.dev/mcp. El plan gratuito de Workers cubre este servidor (100k solicitudes/día; el nivel gratuito de Durable Objects cubre el almacenamiento de sesiones).

Automatizado (GitHub Actions)

.github/workflows/deploy.yml se despliega en cada push a main (y en workflow_dispatch manual). Configura dos secretos de repositorio:

Integración con clientes MCP

Claude Code

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

Agrega --scope user para registrarlo en cada proyecto, o --scope project para confirmar un .mcp.json compartido con colaboradores. Verifica con claude mcp list; dentro de Claude Code, ejecuta /mcp para inspeccionar el estado y las herramientas.

Clientes HTTP Streamable genéricos

Configura clientes que soporten transportes HTTP Streamable para apuntar a la URL desplegada:

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

Para clientes que solo hablan stdio, puentea con mcp-remote:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas para LLMs:

  • convertTimezones: Convierte una cadena de fecha-hora de una zona horaria a otra.
  • mutateDate: Suma o resta días, horas, minutos, meses o años a una cadena de fecha-hora.
  • currentDateTimeAndTimezone: Obtén la fecha, hora y zona horaria actuales.

🧪 Pruebas con MCP Inspector

Ejecuta npm run dev, luego en otra terminal:

npx -y @modelcontextprotocol/inspector

Selecciona el transporte Streamable HTTP y usa http://127.0.0.1:8787/mcp como URL.

Características

  • Conversión de zona horaria
    Convierte una cadena de fecha-hora de una zona horaria IANA a otra usando formatos compatibles con Luxon.

  • Mutación de fecha
    Suma o resta días, horas, minutos, meses o años a una cadena de fecha-hora.

  • Fecha-hora y zona horaria actuales
    Obtén la fecha, hora y zona horaria actuales del usuario/sistema.