O que é Time (reference server)?
O Time é um dos sete servidores de referência ainda mantidos em modelcontextprotocol/servers; ele não foi movido para o repositório servers-archived. É um pequeno servidor Python com duas ferramentas: get_current_time devolve a hora, o dia da semana e o indicador de horário de verão para um fuso IANA como Europe/London, e convert_time converte um horário HH:MM entre dois fusos e informa a diferença de offset. Ele detecta o fuso do sistema ou recebe um por --local-timezone.
Rode-o com uvx mcp-server-time, pip ou a imagem Docker mcp/time; ele só fala stdio e não exige chave nem conta. A versão 2026.10.19 no PyPI o migrou para o MCP Python SDK 2.x e atende às revisões de protocolo 2025-11-25 e 2026-07-28. Os nomes de fuso precisam ser chaves IANA exatas, incluindo maiúsculas: Europe/Warsaw funciona, europe/warsaw é rejeitado.
Como instalar Time (reference server)
uvx mcp-server-timeTime (reference server) vale a pena?
É uma resposta correta e gratuita para um problema estreito, e quanto ela acrescenta depende de o seu cliente já informar a data ao modelo. Modelos de linguagem não têm relógio. Muitos hosts hoje colocam a data atual no prompt de sistema, o que torna get_current_time redundante ali; a ferramenta de conversão é a parte que ainda justifica seu lugar.
A conversão é feita pela base de fusos horários do Python, e não pelo modelo, então 09:00 em Nova York cai na hora certa em Varsóvia mesmo nas semanas em que os EUA e a Europa mudam os relógios em datas diferentes. A versão de outubro de 2026 também recusa um horário de relógio que uma mudança de hora pula, como 02:30 em uma noite de adiantamento de relógio, em vez de devolver uma resposta errada e plausível. Um horário ambíguo no atraso do relógio ainda é convertido sem nenhum aviso, segundo a issue aberta #5196.
O limite real está no código-fonte: convert_time recebe só um horário de relógio e sempre o aplica à data de hoje no fuso de origem. Pergunte sobre uma chamada daqui a três semanas, do outro lado de uma mudança de horário de verão, e o agente recebe o offset de hoje, e não o daquele dia. Não há aritmética de datas, nem calendário, nem noção de horário comercial ou feriados.
O empacotamento tem arestas. Issues abertas relatam que a imagem Docker passa a string literal ${LOCAL_TIMEZONE} para o servidor, então a substituição do fuso falha em silêncio (#5182), e que a imagem roda como root apesar de criar um usuário de app (#4741). Via uvx, nenhuma das duas se aplica, e o que resta são duas ferramentas somente leitura que não tocam arquivos, rede nem credenciais.
Onde ele se destaca
Um desenvolvedor em Londres no Claude Code com colegas em San Francisco e Bangalore
Encontrar um horário de reunião dentro do expediente nas três cidades
O agente chama convert_time para cada horário candidato em vez de adivinhar os offsets, incluindo o de meia hora da Índia. É gratuito e local, mas só responde para a data de hoje, então horários do mês que vem do outro lado de uma mudança de hora precisam ser conferidos à mão.
Um analista de operações em uma central de suporte 24 horas
Converter timestamps de incidentes registrados em UTC para o horário local do engenheiro de plantão
get_current_time fixa o "agora" e convert_time traduz carimbos HH:MM de UTC para, por exemplo, America/Chicago. Não custa nada, mas o modelo precisa passar chaves IANA exatas; "chicago" é rejeitado com um erro que o modelo consegue ler e corrigir.
Um engenheiro aprendendo a escrever servidores MCP em Python
Ler um exemplo pequeno e atual construído sobre o Python SDK 2.x
O servidor inteiro é um único server.py com schemas de saída tipados, resultados estruturados e tratamento de isError para as duas revisões de protocolo. É uma leitura curta que mostra os padrões que o SDK agora espera, sem nenhuma API externa para configurar.
Antes de decidir
- Configuração
- uvx mcp-server-time, ou pip install mcp-server-time; o README traz trechos de configuração para Claude Desktop, Zed, VS Code e Zencoder. Sem credenciais, a primeira chamada de ferramenta funciona assim que o cliente reinicia.
- Integrações
- Duas ferramentas somente leitura: get_current_time (timezone) e convert_time (source_timezone, time, target_timezone). Sem prompts nem resources; os resultados voltam como conteúdo estruturado mais o mesmo JSON em um bloco de texto.
- Dados e privacidade
- Lê apenas o relógio do sistema e a base de fusos horários: sem arquivos, rede ou credenciais. Não busca conteúdo não confiável, então o servidor em si não acrescenta exposição a prompt injection.
- Custo em escala
- Gratuito e local, sem limites de taxa. O único custo são duas pequenas definições de ferramentas por sessão e uma chamada por conversão.
- Limites
- convert_time só aceita HH:MM e assume a data de hoje; horários ambíguos no atraso do relógio são convertidos sem aviso (#5196); o LOCAL_TIMEZONE da imagem Docker é ignorado (#5182); só stdio.
O que é bom
- Sem chave, conta ou acesso à rede
- Conversão feita pela base tz, não pelo modelo
- Rejeita horários pulados por uma mudança de hora
O que não é
- convert_time sempre assume a data de hoje
- A imagem Docker ignora LOCAL_TIMEZONE (issue #5182)
- A ferramenta de hora atual é redundante onde o cliente informa a data
Ideal para
Qualquer pessoa cujo assistente vive errando a hora ou as conversões de fuso horário.
Alternativas ao Time (reference server)
Time (reference server): perguntas frequentes
- Time (reference server) vale a pena?
- Vale a pena adicioná-lo só pela conversão de fusos horários, já que offsets em torno das mudanças de horário de verão são justamente a aritmética que os modelos erram. Damos nota 3.6 de 5.
- Quanto custa Time (reference server)?
- Gratuito e de código aberto.
- Quais são as desvantagens de Time (reference server)?
- convert_time sempre assume a data de hoje; a imagem Docker ignora LOCAL_TIMEZONE (issue #5182); a ferramenta de hora atual é redundante onde o cliente informa a data.
- Para quem Time (reference server) é indicado?
- Qualquer pessoa cujo assistente vive errando a hora ou as conversões de fuso horário.
- Quanto custa Time (reference server) para uma equipe ou em produção?
- Gratuito e local, sem limites de taxa. O único custo são duas pequenas definições de ferramentas por sessão e uma chamada por conversão.
- Time (reference server) é seguro para dados da empresa?
- Lê apenas o relógio do sistema e a base de fusos horários: sem arquivos, rede ou credenciais. Não busca conteúdo não confiável, então o servidor em si não acrescenta exposição a prompt injection.
- Quais são as melhores alternativas ao Time (reference server)?
- As alternativas mais próximas que analisamos são Everything (test server) e Fetch (reference server).
Respostas verificadas em 23 de out. de 2026.