MCP Simple Timeserver
Proporciona la hora local actual, la hora UTC y la información de la zona horaria.
Documentación
MCP Simple Timeserver
Una de las extrañas decisiones de diseño que tomó Anthropic fue privar a Claude de marcas de tiempo para los mensajes enviados por el usuario en claude.ai o de la hora actual en general. ¡Pobre Claude no puede saber qué hora es! mcp-simple-timeserver es un servidor MCP simple que soluciona eso.
Herramientas Disponibles
Este servidor proporciona las siguientes herramientas:
| Herramienta | Descripción |
|---|---|
get_local_time | Devuelve la hora local actual, el día de la semana y la zona horaria de la máquina del usuario |
get_utc | Devuelve la hora UTC precisa desde un servidor de tiempo NTP |
get_current_time | Devuelve la hora actual con ubicación, zona horaria y conversiones de calendario opcionales |
calculate_time_distance | Calcula la duración entre dos fechas/horas (cuentas regresivas, tiempo transcurrido) |
get_holidays | Devuelve los días festivos públicos (y opcionalmente los escolares) de un país |
is_holiday | Comprueba si una fecha específica es festiva en un país o ciudad determinados |
Todas las herramientas (excepto get_local_time) utilizan la hora precisa de los servidores NTP. Si NTP no está disponible, recurren de forma elegante a la hora local del servidor con un aviso.
Soporte de Ubicación mediante get_current_time
La herramienta get_current_time admite parámetros de ubicación para obtener la hora local en cualquier parte del mundo:
| Parámetro | Descripción | Ejemplo |
|---|---|---|
city | Nombre de la ciudad (caso de uso principal) | "Warsaw", "Tokyo", "New York" |
country | Nombre del país o código ISO | "Poland", "JP", "United States" |
timezone | Zona horaria IANA o desfase UTC | "Europe/Warsaw", "+05:30" |
Prioridad: timezone > city > country. Cuando se proporciona una ubicación, la respuesta incluye la hora local, la información de la zona horaria, el desfase UTC y el estado del horario de verano.
Si hoy es un día festivo público en la ubicación especificada, se mostrará en la salida.
Soporte de Calendario mediante get_current_time
La herramienta get_current_time también acepta un parámetro opcional calendar con una lista separada por comas de formatos de calendario:
| Calendario | Descripción |
|---|---|
unix | Marca de tiempo Unix (segundos desde 1970-01-01) |
isodate | Fecha semanal ISO 8601 (p. ej., 2026-W03-6) |
hijri | Calendario lunar islámico/hiyri |
japanese | Calendario de era japonesa (devuelve tanto en inglés como en kanji) |
hebrew | Calendario hebreo/judío (devuelve tanto en inglés como en hebreo, incluye festividades) |
persian | Calendario persa/jalali (devuelve tanto en inglés como en farsi) |
Ejemplo: get_current_time(city="Tokyo", calendar="japanese") devuelve la hora local de Tokio con el calendario de era japonesa.
Cálculo de Distancia Temporal mediante calculate_time_distance
Calcula la duración entre dos fechas u horas:
| Parámetro | Descripción | Ejemplo |
|---|---|---|
from_date | Fecha de inicio (ISO 8601 o "now") | "2025-01-15", "now" |
to_date | Fecha de fin (ISO 8601 o "now") | "2025-12-31", "2025-06-01T17:00:00" |
unit | Formato de salida | "auto", "days", "weeks", "hours", "minutes", "seconds" |
business_days | Contar solo de lunes a viernes (basado en fechas, inclusivo) | true |
exclude_holidays | Excluir también los días festivos públicos (requiere país/ciudad) | true |
Los parámetros de ubicación (city, country, timezone) también se pueden usar para especificar el contexto de la zona horaria.
Cuando business_days=true, se ignora la hora del día y las fechas se cuentan como días completos (extremos inclusivos).
El parámetro unit se ignora en este modo. Los días festivos se excluyen solo cuando caen en días laborables.
Ejemplo: calculate_time_distance(from_date="now", to_date="2025-12-31") devuelve una cuenta regresiva hasta Nochevieja.
Ejemplo: calculate_time_distance(from_date="2026-01-26", to_date="2026-01-30", business_days=true, exclude_holidays=true, city="Sydney") devuelve el número de días laborables en ese rango.
Información de Días Festivos mediante get_holidays y is_holiday
Obtén información sobre días festivos públicos y escolares de ~119 países:
Parámetros de get_holidays:
| Parámetro | Descripción | Ejemplo |
|---|---|---|
country | Nombre del país o código ISO (obligatorio) | "Poland", "DE", "United States" |
year | Año para el que obtener los días festivos (por defecto: año actual) | 2026 |
include_school_holidays | Incluir períodos de vacaciones escolares | true |
Parámetros de is_holiday:
| Parámetro | Descripción | Ejemplo |
|---|---|---|
country | Nombre del país o código ISO | "Poland", "US" |
city | Nombre de la ciudad para información específica de la región | "Warsaw", "Munich" |
date | Fecha a comprobar en formato ISO (por defecto: hoy) | "2026-01-01" |
Vacaciones Escolares Regionales: Al usar el parámetro city con is_holiday, las vacaciones escolares se filtran para mostrar solo las que afectan a la región específica. Esto es particularmente útil en países donde las vacaciones escolares varían según la región (p. ej., voivodatos polacos, Bundesländer alemanes, comunidades autónomas españolas).
Ejemplo: is_holiday(city="Warsaw", date="2026-01-19") devuelve información de vacaciones escolares específica del voivodato de Mazowieckie.
Fuentes de Datos:
- Días festivos públicos: API de Nager.Date (119 países)
- Vacaciones escolares: OpenHolidaysAPI (36 países, mayormente europeos)
Instalación
Instalación mediante Smithery
Para instalar Simple Timeserver para Claude Desktop automáticamente mediante Smithery:
npx -y @smithery/cli install mcp-simple-timeserver --client claude
Instalación Manual
Primero instala el módulo usando:
pip install mcp-simple-timeserver
Luego configura en el cliente MCP: la aplicación de escritorio de Claude.
En Mac OS esto se verá así:
"mcpServers": {
"simple-timeserver": {
"command": "python",
"args": ["-m", "mcp_simple_timeserver"]
}
}
En Windows debes comprobar la ruta a tu ejecutable de Python usando where python en el cmd (línea de comandos de Windows).
Una configuración típica se vería así:
"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 proyecto también incluye una versión alojable en red que se puede implementar como un servidor web independiente. Para instrucciones sobre cómo ejecutarlo e implementarlo, consulta la Guía de Implementación del Servidor Web.
O simplemente puedes usar mi servidor añadiéndolo bajo https://mcp.andybrandt.net/timeserver a Claude y otras herramientas que admitan MCP.