Skip to content

Time (reference server)

Servidor oficial de referencia de MCP que da a un modelo la hora actual y convierte horas entre zonas horarias IANA.

Reseña de Sheela · Actualizado

Nuestra nota

3.6/5

Merece la pena añadirlo solo por la conversión entre zonas horarias, ya que los desfases en torno a los cambios de hora son justo la aritmética en la que fallan los modelos.

¿Qué es Time (reference server)?

Time es uno de los siete servidores de referencia que siguen mantenidos en modelcontextprotocol/servers; no se ha trasladado al repositorio servers-archived. Es un servidor pequeño de Python con dos herramientas: get_current_time devuelve la hora, el día de la semana y el indicador de horario de verano para una zona IANA como Europe/London, y convert_time convierte una hora HH:MM entre dos zonas e indica la diferencia de desfase. Detecta la zona del sistema o toma una de --local-timezone.

Se ejecuta con uvx mcp-server-time, pip o la imagen de Docker mcp/time; solo habla stdio y no necesita clave ni cuenta. La versión 2026.10.19 de PyPI lo pasó al MCP Python SDK 2.x y admite tanto la revisión 2025-11-25 como la 2026-07-28 del protocolo. Los nombres de zona deben ser claves IANA exactas, mayúsculas incluidas: Europe/Warsaw funciona, europe/warsaw se rechaza.

Cómo instalar Time (reference server)

uvx mcp-server-time

¿Merece la pena Time (reference server)?

Es una respuesta correcta y gratuita a un problema acotado, y cuánto aporta depende de si tu cliente ya le dice la fecha al modelo. Los modelos de lenguaje no tienen reloj. Muchos hosts ponen ya la fecha actual en el prompt del sistema, lo que hace redundante get_current_time en ese caso; la herramienta de conversión es la parte que sigue ganándose su sitio.

La conversión la hace la base de datos de zonas horarias de Python y no el modelo, así que las 09:00 en Nueva York caen en la hora correcta en Varsovia incluso en las semanas en que Estados Unidos y Europa cambian la hora en fechas distintas. La versión de octubre de 2026 también rechaza una hora de reloj que un cambio de hora se salta, como las 02:30 de una noche en que se adelanta el reloj, en lugar de devolver una respuesta errónea pero verosímil. Una hora ambigua por el retraso del reloj se sigue convirtiendo sin ningún aviso, según la issue abierta #5196.

El límite real está en el código fuente: convert_time solo acepta una hora de reloj y siempre la aplica a la fecha de hoy en la zona de origen. Pregunta por una llamada dentro de tres semanas, al otro lado de un cambio de hora, y el agente obtiene el desfase de hoy y no el de ese día. No hay aritmética de fechas, ni calendario, ni noción de horario laboral o festivos.

El empaquetado tiene asperezas. Hay issues abiertas que informan de que la imagen de Docker pasa al servidor la cadena literal ${LOCAL_TIMEZONE}, así que la zona configurada falla sin avisar (#5182), y de que la imagen se ejecuta como root pese a crear un usuario para la app (#4741). Con uvx no se aplica ninguno de los dos, y lo que queda son dos herramientas de solo lectura que no tocan archivos, red ni credenciales.

Dónde se gana su sitio

  • Un desarrollador en Londres con Claude Code y compañeros en San Francisco y Bangalore

    Encontrar un hueco para una reunión dentro del horario laboral de las tres ciudades

    El agente llama a convert_time para cada hueco candidato en lugar de adivinar los desfases, incluido el de media hora de la India. Es gratuito y local, pero solo responde para la fecha de hoy, así que los huecos del mes que viene al otro lado de un cambio de hora hay que comprobarlos a mano.

  • Una analista de operaciones en un servicio de soporte 24 horas

    Pasar las marcas de tiempo de incidencias registradas en UTC a la hora local del ingeniero de guardia

    get_current_time fija el "ahora" y convert_time traduce las marcas HH:MM de UTC a, por ejemplo, America/Chicago. No cuesta nada, pero el modelo debe pasar claves IANA exactas; "chicago" se rechaza con un error que el modelo puede leer y corregir.

  • Un ingeniero que aprende a escribir servidores MCP en Python

    Leer un ejemplo pequeño y actual basado en el Python SDK 2.x

    Todo el servidor es un único server.py con esquemas de salida tipados, resultados estructurados y gestión de isError para ambas revisiones del protocolo. Es una lectura corta que muestra los patrones que espera ahora el SDK, sin ninguna API externa que configurar.

Antes de decidirte

Puesta en marcha
uvx mcp-server-time, o pip install mcp-server-time; el README trae fragmentos de configuración para Claude Desktop, Zed, VS Code y Zencoder. Sin credenciales, la primera llamada a una herramienta funciona en cuanto se reinicia el cliente.
Integraciones
Dos herramientas de solo lectura: get_current_time (timezone) y convert_time (source_timezone, time, target_timezone). Sin prompts ni resources; los resultados vuelven como contenido estructurado más el mismo JSON en un bloque de texto.
Datos y privacidad
Solo lee el reloj del sistema y la base de datos de zonas horarias: sin archivos, red ni credenciales. No obtiene contenido no fiable, así que el propio servidor no añade exposición a la inyección de prompts.
Coste a escala
Gratuito y local, sin límites de peticiones. El único coste son dos definiciones de herramientas pequeñas por sesión y una llamada por conversión.
Límites
convert_time solo acepta HH:MM y supone la fecha de hoy; las horas ambiguas por el retraso del reloj se convierten sin aviso (#5196); la imagen de Docker ignora LOCAL_TIMEZONE (#5182); solo stdio.

Lo bueno

  • Sin clave, cuenta ni acceso a la red
  • La conversión la hace la base de datos tz, no el modelo
  • Rechaza las horas que se salta un cambio de hora

Lo malo

  • convert_time siempre supone la fecha de hoy
  • La imagen de Docker ignora LOCAL_TIMEZONE (issue #5182)
  • La herramienta de hora actual es redundante si el cliente ya pasa la fecha

Ideal para

Cualquiera cuyo asistente se equivoque una y otra vez con la hora o con las conversiones entre zonas horarias.

Alternativas a Time (reference server)

Time (reference server): preguntas frecuentes

¿Merece la pena Time (reference server)?
Merece la pena añadirlo solo por la conversión entre zonas horarias, ya que los desfases en torno a los cambios de hora son justo la aritmética en la que fallan los modelos. Le damos un 3.6 sobre 5.
¿Cuánto cuesta Time (reference server)?
Gratuito y de código abierto.
¿Qué inconvenientes tiene Time (reference server)?
convert_time siempre supone la fecha de hoy; la imagen de Docker ignora LOCAL_TIMEZONE (issue #5182); la herramienta de hora actual es redundante si el cliente ya pasa la fecha.
¿Para quién es Time (reference server)?
Cualquiera cuyo asistente se equivoque una y otra vez con la hora o con las conversiones entre zonas horarias.
¿Cuánto cuesta Time (reference server) para un equipo o en producción?
Gratuito y local, sin límites de peticiones. El único coste son dos definiciones de herramientas pequeñas por sesión y una llamada por conversión.
¿Es Time (reference server) seguro para los datos de la empresa?
Solo lee el reloj del sistema y la base de datos de zonas horarias: sin archivos, red ni credenciales. No obtiene contenido no fiable, así que el propio servidor no añade exposición a la inyección de prompts.
¿Cuáles son las mejores alternativas a Time (reference server)?
Las alternativas más cercanas que hemos analizado son Everything (test server) y Fetch (reference server).

Respuestas comprobadas el 23 oct 2026.