MCP de herramientas de fecha y hora

Un servidor del Protocolo de Contexto de Modelo (MCP) para la manipulación de fecha y hora y la conversión de zonas horarias.

Descripción general

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

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

Related MCP server: Time MCP Server

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 a través del envoltorio McpAgent de agents de Cloudflare.

Endpoints:

• POST/GET/DELETE /mcp — Transporte HTTP transmitible. Sesiones rastreadas a través del encabezado mcp-session-id.

• GET /sse, POST /sse/message — Transporte SSE heredado para clientes más 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 (100 mil 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). Configure dos secretos de repositorio:

• CLOUDFLARE_API_TOKEN — créelo en https://dash.cloudflare.com/profile/api-tokens usando la plantilla Edit Cloudflare Workers

• CLOUDFLARE_ACCOUNT_ID — se encuentra en la barra lateral del panel de control de Workers & Pages

Integración con clientes MCP

Claude Code

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

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

Clientes HTTP transmitibles genéricos

Configure los clientes que admiten transportes HTTP transmitibles para que apunten a la URL desplegada:

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

Para clientes que solo admiten stdio, cree un puente 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 y hora de una zona horaria a otra.

• mutateDate: Suma o resta días, horas, minutos, meses o años de una cadena de fecha y hora.

• currentDateTimeAndTimezone: Obtiene la fecha, hora y zona horaria actuales.

🧪 Pruebas con MCP Inspector

Ejecute npm run dev, luego en otra terminal:

npx -y @modelcontextprotocol/inspector

Seleccione el transporte Streamable HTTP y utilice http://127.0.0.1:8787/mcp como URL.

Características

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

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

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