Time MCP Server

Time MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de hora y conversión de zonas horarias. Este servidor permite a los LLMs obtener información de hora actual y realizar conversiones de zonas horarias utilizando nombres de zonas horarias IANA, con detección automática de la zona horaria del sistema.

Herramientas Disponibles

• get_current_time - Obtener la hora actual en una zona horaria específica o la zona horaria del sistema.

  • Argumentos requeridos:
    • timezone (cadena): Nombre de zona horaria IANA (ej., 'America/New_York', 'Europe/London')

• convert_time - Convertir hora entre zonas horarias.

  • Argumentos requeridos:
    • source_timezone (cadena): Nombre de zona horaria IANA de origen
    • time (cadena): Hora en formato de 24 horas (HH:MM)
    • target_timezone (cadena): Nombre de zona horaria IANA de destino

Instalación

Usando uv (recomendado)

Cuando se usa uv no se necesita instalación específica. Usaremos uvx para ejecutar directamente pape-mcp-server-time.

Usando PIP

Alternativamente, puedes instalar pape-mcp-server-time vía pip:

pip install pape-mcp-server-time

Después de la instalación, puedes ejecutarlo como un script usando:

python -m pape_mcp_server_time

Configuración

Configurar para Claude.app

Añade a tu configuración de Claude:

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

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "pape_mcp_server_time"]
    }
  }
}

Configurar para Zed

Añade a tu settings.json de Zed:

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

"context_servers": {
  "pape-mcp-server-time": {
    "command": "python",
    "args": ["-m", "pape_mcp_server_time"]
  }
},

Configurar para VS Code

Para una instalación rápida, usa uno de los botones de instalación con un clic a continuación...

Para instalación manual, añade el siguiente bloque JSON a tu archivo de Configuración de Usuario (JSON) en VS Code. Puedes hacer esto presionando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

Opcionalmente, puedes añadirlo a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otros.

Nota que la clave mcp es necesaria cuando se usa el archivo mcp.json.

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

Personalización - Zona Horaria del Sistema

Por defecto, el servidor detecta automáticamente la zona horaria de tu sistema. Puedes anular esto añadiendo el argumento --local-timezone a la lista args en la configuración.

Ejemplo:

{
  "command": "python",
  "args": ["-m", "pape_mcp_server_time", "--local-timezone=America/New_York"]
}

Interacciones de Ejemplo

1. Obtener la hora actual:

   {
     "name": "get_current_time",
     "arguments": {
       "timezone": "Europe/Warsaw"
     }
   }
   

   Respuesta:

   {
     "timezone": "Europe/Warsaw",
     "datetime": "2024-01-01T13:00:00+01:00",
     "is_dst": false
   }
   

2. Convertir hora entre zonas horarias:

   {
     "name": "convert_time",
     "arguments": {
       "source_timezone": "America/New_York",
       "time": "16:30",
       "target_timezone": "Asia/Tokyo"
     }
   }
   

   Respuesta:

   {
     "source": {
       "timezone": "America/New_York",
       "datetime": "2024-01-01T12:30:00-05:00",
       "is_dst": false
     },
     "target": {
       "timezone": "Asia/Tokyo",
       "datetime": "2024-01-01T12:30:00+09:00",
       "is_dst": false
     },
     "time_difference": "+13.0h",
   }
   

Depuración

Puedes usar el inspector MCP para depurar el servidor. Para instalaciones uvx:

npx @modelcontextprotocol/inspector uvx pape-mcp-server-time

O si has instalado el paquete en un directorio específico o estás desarrollando en él:

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run pape-mcp-server-time

Ejemplos de Preguntas para Claude

1. "¿Qué hora es ahora?" (usará la zona horaria del sistema)
2. "¿Qué hora es en Tokio?"
3. "Cuando son las 4 PM en Nueva York, ¿qué hora es en Londres?"
4. "Convierte las 9:30 AM hora de Tokio a hora de Nueva York"

Contribuciones

Animamos las contribuciones para ayudar a expandir y mejorar pape-mcp-server-time. Ya sea que quieras añadir nuevas herramientas relacionadas con el tiempo, mejorar la funcionalidad existente o mejorar la documentación, tu aporte es valioso.

Para ejemplos de otros servidores MCP y patrones de implementación, consulta: https://github.com/modelcontextprotocol/servers

¡Las solicitudes de extracción son bienvenidas! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras para hacer pape-mcp-server-time aún más potente y útil.

Licencia

pape-mcp-server-time está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.