Time MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Nomes de fusos horários IANA (America/Los_Angeles, Europe/Berlin) — lida corretamente com DST
Sempre retorna a hora atual real — Claude sozinho não sabe
Duas ferramentas, zero cerimônia
Sem chave API, sem chamadas de rede além do relógio do servidor

Demo ao vivo

Como fica na prática

time.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "time",
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "time": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-server-time"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add time -- uvx mcp-server-time

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Time

Encontrar um horário de reunião que funcione em 4 fusos horários

👤 Qualquer pessoa agendando com um time distribuído ⏱ ~3 min beginner

Quando usar: Você precisa de um slot de 30 minutos que não seja 6am para alguém ou 10pm para outra pessoa.

Fluxo

Estabeleça Claude no horário atual real

Qual é a hora atual em America/Los_Angeles, America/New_York, Europe/London e Asia/Tokyo?✓ Copiado

→ Quatro horários de relógio corretos, não palpites obsoletos
Converta slots candidatos

Converta 10:00 America/Los_Angeles na próxima terça para as outras 3 zonas. Sinalize se cair fora de 8am-7pm local para alguém.✓ Copiado

→ Tabela de 4 linhas com sinalizador de fora do horário
Proponha 2 slots humanizados

Sugira 2 slots recorrentes semanais que mantenham todos dentro de 8am-6pm local. Sem slots que exijam que alguém trabalhe no fim de semana.✓ Copiado

→ Duas opções viáveis com desvantagens

Resultado: Um horário de reunião humanizado com a matemática de conversão mostrada, pronto para enviar como um convite de calendário.

Armadilhas

Transições de DST invertem o offset no meio do caminho — Sempre use nomes de zona IANA (America/Los_Angeles), nunca offsets como 'UTC-8' que ficam obsoletos na mudança de DST
Zonas de offset de meia hora (Índia, Nepal, partes da Austrália) — Confie na ferramenta — ela lida com essas; não deixe Claude arredondar para horas

Depurar um bug de timestamp convertendo tempos de log para sua zona local

👤 Engenheiros lendo logs UTC enquanto resolvem problemas ⏱ ~5 min beginner

Quando usar: Seus logs estão em UTC, seu cérebro está no Pacífico, e a correlação de incidentes continua dando errado.

Fluxo

Traduza a janela de incidente

Converta 2026-04-14T22:37:00Z para America/Los_Angeles. Também me dê o mesmo momento em Europe/Amsterdam onde nosso ops on-call estava.✓ Copiado

→ Dois horários locais lado a lado
Confirme o estado de DST

DST estava em vigor em America/Los_Angeles naquele instante? Qual era o offset UTC?✓ Copiado

→ Offset impresso (por ex., -07:00), DST confirmado
Correlacione com eventos humanos

Dado que o incidente foi 15:37 PT, isso se alinha com a thread do Slack de 'segunda à tarde'?✓ Copiado

→ Verificação de sanidade contra horários nomeados por humanos

Resultado: Você para de culpar o deploy errado porque finalmente tem os horários certos.

Armadilhas

Misturar 'Z', '+00:00' e timestamps ingênuos — Sempre converta para UTC explícito primeiro; rejeite qualquer timestamp sem uma zona no prompt

Combine com: sentry · postgres

Combinações

Combine com outros MCPs para 10× de alavancagem

time + sentry

Traduza horários de início/fim do incidente para zonas locais para narrativa pós-incidente

Para o incidente Sentry INC-42, converta os timestamps de início e fim para America/Los_Angeles e Europe/Berlin e escreva a linha do tempo pós-incidente.✓ Copiado

time + postgres

Consulte com limites de dia local corretos quando seu DB armazena UTC

Quantas inscrições aconteceram em 2026-04-13 no horário local America/Los_Angeles? Use a ferramenta de tempo para calcular o intervalo UTC, depois consulte eventos.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
get_current_time	timezone: str (nome IANA, por ex. 'Europe/Berlin')	Estabeleça o modelo no horário real do relógio antes de qualquer raciocínio de data	grátis
convert_time	source_timezone: str, time: str (HH:MM), target_timezone: str	Converta um horário de relógio específico entre duas zonas	grátis

Custo e limites

O que custa rodar

Cota de API: Nenhum — computação local pura
Tokens por chamada: Minúsculo — algumas centenas de tokens por chamada
Monetário: Grátis
Dica: Sem preocupações de orçamento. Chame-a livremente sempre que datas estiverem envolvidas.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhum — lê o relógio do sistema do servidor e tzdata

A precisão depende do tzdata do OS do servidor estar atualizado — raro mas real quando legislações mudam as regras de DST no meio do ano.

Solução de problemas

Erros comuns e correções

Fuso horário desconhecido: 'PST'

Use nomes IANA, não abreviações. 'PST' → 'America/Los_Angeles'. 'EST' → 'America/New_York'. Abreviações são ambíguas (IST = Índia ou Irlanda?).

O tempo retornado parece estar uma hora desligado

Caso extremo de transição de DST. Verifique com o campo is_dst — se estiver errado, o tzdata do seu servidor está obsoleto. Atualize o banco de dados de fuso horário do sistema.

Verificar: zdump -v America/Los_Angeles | head

convert_time retorna 'ambiguous time' durante a retração de DST

A hora do relógio acontece duas vezes (1:30am ocorre duas vezes). Especifique uma data-hora, não apenas um horário, para conversão não ambígua.

Alternativas

Time vs. outros

Alternativa	Quando usar	Troca
Um MCP de calendário dedicado (Google Calendar)	Você deseja realmente agendar a reunião, não apenas calcular horários	Mais pesado, precisa de OAuth — mas fecha o loop para um convite

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills