Date-time Tools

Um servidor para manipulação de data-hora e conversão de fuso horário.

GitHub

Documentação

Date-time Tools MCP

Um servidor Model Context Protocol (MCP) para manipulação de data-hora e conversão de fusos horários.

Visão Geral

Este servidor MCP fornece um conjunto de ferramentas para trabalhar com strings de data-hora, incluindo conversão de fusos horários, mutação de datas (aritmética) e obtenção da data-hora e fuso horário atuais. Ele foi projetado para ser usado como um utilitário de backend para aplicações ou agentes que precisam de operações de data-hora robustas e padronizadas.

Implantação ao vivo: https://date-time-tools.iabhishek.workers.dev/mcp

Arquitetura

Este servidor roda em Cloudflare Workers e usa o transporte Streamable HTTP (com um endpoint SSE legado também exposto). O estado por sessão é armazenado em um Durable Object via wrapper agents McpAgent da Cloudflare.

Endpoints:

  • POST/GET/DELETE /mcp — Transporte Streamable HTTP. Sessões rastreadas via cabeçalho mcp-session-id.
  • GET /sse, POST /sse/message — Transporte SSE legado para clientes mais antigos.

Desenvolvimento local

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

Implantação no Cloudflare

Manual

Configuração única:

npx wrangler login

Implantar:

npm run deploy

O Wrangler exibe a URL pública — para este projeto é https://date-time-tools.iabhishek.workers.dev/mcp. O plano gratuito do Workers cobre este servidor (100 mil requisições/dia; o nível gratuito do Durable Objects cobre o armazenamento de sessões).

Automatizado (GitHub Actions)

.github/workflows/deploy.yml implanta a cada push para main (e em workflow_dispatch manual). Configure dois segredos do repositório:

Integração com Clientes MCP

Claude Code

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

Adicione --scope user para registrá-lo em todos os projetos, ou --scope project para commitar um .mcp.json compartilhado com colaboradores. Verifique com claude mcp list; dentro do Claude Code, execute /mcp para inspecionar o status e as ferramentas.

Clientes Streamable HTTP genéricos

Configure clientes que suportam transportes Streamable HTTP para apontar para a URL implantada:

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

Para clientes que só falam stdio, faça a ponte com mcp-remote:

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

Ferramentas Disponíveis

Este servidor MCP fornece as seguintes ferramentas para LLMs:

  • convertTimezones: Converte uma string de data-hora de um fuso horário para outro.
  • mutateDate: Adiciona ou subtrai dias, horas, minutos, meses ou anos de uma string de data-hora.
  • currentDateTimeAndTimezone: Obtém a data, hora e fuso horário atuais.

🧪 Testando com o MCP Inspector

Execute npm run dev e, em outro terminal:

npx -y @modelcontextprotocol/inspector

Selecione o transporte Streamable HTTP e use http://127.0.0.1:8787/mcp como URL.

Recursos

  • Conversão de Fusos Horários
    Converte uma string de data-hora de um fuso horário IANA para outro usando formatos compatíveis com Luxon.

  • Mutação de Datas
    Adiciona ou subtrai dias, horas, minutos, meses ou anos de uma string de data-hora.

  • Data-Hora e Fuso Horário Atuais
    Recupera a data, hora e fuso horário atuais do usuário/sistema.