MCP Simple Timeserver
Fornece horário local atual, horário UTC e informações de fuso horário.
Documentação
MCP Simple Timeserver
Uma das decisões de design estranhas que a Anthropic tomou foi privar o Claude de timestamps para mensagens enviadas pelo usuário no claude.ai ou da hora atual em geral. Pobre Claude não consegue saber que horas são! mcp-simple-timeserver é um servidor MCP simples que resolve isso.
Ferramentas Disponíveis
Este servidor fornece as seguintes ferramentas:
| Ferramenta | Descrição |
|---|---|
get_local_time | Retorna a hora local atual, dia da semana e fuso horário da máquina do usuário |
get_utc | Retorna a hora UTC precisa de um servidor de tempo NTP |
get_current_time | Retorna a hora atual com localização, fuso horário e conversões de calendário opcionais |
calculate_time_distance | Calcula a duração entre duas datas/horas (contagens regressivas, tempo decorrido) |
get_holidays | Retorna feriados públicos (e opcionalmente feriados escolares) para um país |
is_holiday | Verifica se uma data específica é feriado em um determinado país ou cidade |
Todas as ferramentas (exceto get_local_time) usam hora precisa de servidores NTP. Se o NTP estiver indisponível, elas usam graciosamente a hora local do servidor como fallback, com um aviso.
Suporte a Localização via get_current_time
A ferramenta get_current_time suporta parâmetros de localização para obter a hora local em qualquer lugar do mundo:
| Parâmetro | Descrição | Exemplo |
|---|---|---|
city | Nome da cidade (caso de uso principal) | "Warsaw", "Tokyo", "New York" |
country | Nome do país ou código ISO | "Poland", "JP", "United States" |
timezone | Fuso horário IANA ou offset UTC | "Europe/Warsaw", "+05:30" |
Prioridade: timezone > city > country. Quando a localização é fornecida, a resposta inclui hora local, informações de fuso horário, offset UTC e status de horário de verão.
Se hoje for um feriado público no local especificado, ele será exibido na saída.
Suporte a Calendário via get_current_time
A ferramenta get_current_time também aceita um parâmetro opcional calendar com uma lista separada por vírgulas de formatos de calendário:
| Calendário | Descrição |
|---|---|
unix | Timestamp Unix (segundos desde 1970-01-01) |
isodate | Data da semana ISO 8601 (ex.: 2026-W03-6) |
hijri | Calendário lunar islâmico/Hijri |
japanese | Calendário de Era Japonesa (retorna tanto em inglês quanto em Kanji) |
hebrew | Calendário hebraico/judeu (retorna tanto em inglês quanto em hebraico, inclui feriados) |
persian | Calendário persa/Jalali (retorna tanto em inglês quanto em farsi) |
Exemplo: get_current_time(city="Tokyo", calendar="japanese") retorna a hora local de Tóquio com o calendário de Era Japonesa.
Cálculo de Distância de Tempo via calculate_time_distance
Calcule a duração entre duas datas ou horários:
| Parâmetro | Descrição | Exemplo |
|---|---|---|
from_date | Data de início (ISO 8601 ou "now") | "2025-01-15", "now" |
to_date | Data de fim (ISO 8601 ou "now") | "2025-12-31", "2025-06-01T17:00:00" |
unit | Formato de saída | "auto", "days", "weeks", "hours", "minutes", "seconds" |
business_days | Contar apenas seg-sex (baseado em data, inclusivo) | true |
exclude_holidays | Também excluir feriados públicos (requer país/cidade) | true |
Parâmetros de localização (city, country, timezone) também podem ser usados para especificar o contexto de fuso horário.
Quando business_days=true, a hora do dia é ignorada e as datas são contadas como dias completos (pontos finais inclusivos).
O parâmetro unit é ignorado neste modo. Feriados são excluídos apenas quando caem em dias úteis.
Exemplo: calculate_time_distance(from_date="now", to_date="2025-12-31") retorna uma contagem regressiva para a véspera de Ano Novo.
Exemplo: calculate_time_distance(from_date="2026-01-26", to_date="2026-01-30", business_days=true, exclude_holidays=true, city="Sydney") retorna o número de dias úteis nesse intervalo.
Informações de Feriados via get_holidays e is_holiday
Obtenha informações de feriados públicos e escolares para ~119 países:
Parâmetros de get_holidays:
| Parâmetro | Descrição | Exemplo |
|---|---|---|
country | Nome do país ou código ISO (obrigatório) | "Poland", "DE", "United States" |
year | Ano para obter feriados (padrão: ano atual) | 2026 |
include_school_holidays | Incluir períodos de férias escolares | true |
Parâmetros de is_holiday:
| Parâmetro | Descrição | Exemplo |
|---|---|---|
country | Nome do país ou código ISO | "Poland", "US" |
city | Nome da cidade para informações específicas da região | "Warsaw", "Munich" |
date | Data para verificar no formato ISO (padrão: hoje) | "2026-01-01" |
Férias Escolares Regionais: Ao usar o parâmetro city com is_holiday, as férias escolares são filtradas para mostrar apenas aquelas que afetam a região específica. Isso é particularmente útil em países onde as férias escolares variam por região (ex.: voivodias polonesas, estados alemães, comunidades autônomas espanholas).
Exemplo: is_holiday(city="Warsaw", date="2026-01-19") retorna informações de férias escolares específicas para a voivodia de Mazóvia.
Fontes de Dados:
- Feriados públicos: API Nager.Date (119 países)
- Férias escolares: OpenHolidaysAPI (36 países, principalmente europeus)
Instalação
Instalando via Smithery
Para instalar o Simple Timeserver para Claude Desktop automaticamente via Smithery:
npx -y @smithery/cli install mcp-simple-timeserver --client claude
Instalação Manual
Primeiro instale o módulo usando:
pip install mcp-simple-timeserver
Em seguida, configure no cliente MCP - o aplicativo de desktop do Claude.
No Mac OS, isso ficará assim:
"mcpServers": {
"simple-timeserver": {
"command": "python",
"args": ["-m", "mcp_simple_timeserver"]
}
}
No Windows, você precisa verificar o caminho para o seu executável Python usando where python no cmd (linha de comando do Windows).
Uma configuração típica ficaria assim:
"mcpServers": {
"simple-timeserver": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": ["-m", "mcp_simple_timeserver"]
}
}
Variante de Servidor Web
Este projeto também inclui uma versão hospedável em rede que pode ser implantada como um servidor web autônomo. Para instruções sobre como executar e implantar, consulte o Guia de Implantação do Servidor Web.
Ou você pode simplesmente usar meu servidor adicionando-o sob https://mcp.andybrandt.net/timeserver ao Claude e outras ferramentas que suportam MCP.