MCP Time Server

Servidor de Tiempo MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funcionalidad de hora y fecha. Este servidor expone herramientas para obtener la hora actual, la fecha y formatear marcas de tiempo en varios formatos y zonas horarias.

Características

• get_current_time: Obtener la hora actual en formato ISO, local, UTC o marca de tiempo Unix
• get_current_date: Obtener la fecha actual en varios formatos (ISO, local, corto, largo, personalizado)
• get_datetime_info: Obtener información completa de fecha/hora, incluidos detalles de la zona horaria
• format_timestamp: Formatear cualquier marca de tiempo Unix a formatos legibles

Instalación

1. Clona el servidor MCP:

git clone https://github.com/PierreGode/timeMCP.git
cd timeMCP

2. Guarda el código del servidor como timeserver.js y la configuración del paquete como package.json

3. Instala las dependencias:

npm install

4. Si estás en Linux, haz ejecutable el servidor:

chmod +x timeserver.js

Uso

Ejecutar el Servidor

El servidor se ejecuta en transporte stdio (entrada/salida estándar):

node timeserver.js

Para ejecutar el servidor, debes agregarlo a tu configuración de MCP. Por ejemplo, si usas Claude Desktop, puedes hacerlo modificando el archivo claude_desktop_config.json. Por alguna razón, Claude podría no reconocer el servidor hasta que reinstales la aplicación de escritorio de Claude, por lo que es posible que debas hacerlo después de agregar el servidor.

Ejemplo de Configuración para Claude Desktop

edit claude_desktop_config.json
```bash
{
  "mcpServers": {
    "time-server": {
      "command": "node",
      "args": ["C:\\Users\\youruser\\Documents\\timeMCP\\timeserver.js"],
      "env": {}
    }
  }
}

Herramientas Disponibles

1. get_current_time

Obtener la hora actual en varios formatos.

Parámetros:

• format (opcional): "iso", "local", "utc" o "unix" (predeterminado: "iso")
• timezone (opcional): Cadena de zona horaria como "America/New_York" (predeterminado: "local")

Ejemplo:

{
  "format": "local",
  "timezone": "Europe/London"
}

2. get_current_date

Obtener la fecha actual en varios formatos.

Parámetros:

• format (opcional): "iso", "local", "short", "long" o "custom" (predeterminado: "iso")
• customFormat (opcional): Cadena JSON de opciones de Intl.DateTimeFormat (cuando el formato es "custom")
• timezone (opcional): Cadena de zona horaria (predeterminado: "local")

Ejemplo:

{
  "format": "long",
  "timezone": "Asia/Tokyo"
}

3. get_datetime_info

Obtener información completa de fecha y hora.

Parámetros:

• timezone (opcional): Cadena de zona horaria (predeterminado: "local")

Ejemplo:

{
  "timezone": "America/Los_Angeles"
}

4. format_timestamp

Formatear una marca de tiempo Unix.

Parámetros:

• timestamp (obligatorio): Marca de tiempo Unix en milisegundos
• format (opcional): "iso", "local", "utc" o "custom" (predeterminado: "iso")
• timezone (opcional): Cadena de zona horaria (predeterminado: "local")

Ejemplo:

{
  "timestamp": 1703097600000,
  "format": "local",
  "timezone": "UTC"
}

Integración con Clientes MCP

Para usar este servidor con un cliente MCP (como Claude Desktop), agrégalo a tu configuración de MCP:

Configuración de Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "node",
      "args": ["/path/to/your/mcp-time-server/server.js"],
      "env": {}
    }
  }
}

Otros Clientes MCP

Para otros clientes MCP, consulta su documentación sobre cómo configurar servidores MCP. El servidor utiliza transporte stdio y sigue el protocolo MCP estándar.

Respuestas de Ejemplo

Hora Actual (formato ISO):

Current time (iso): 2024-12-20T14:30:45.123Z

Fecha Actual (formato largo):

Current date (long): Friday, December 20, 2024

Información de Fecha/Hora:

{
  "timestamp": 1703097845123,
  "iso": "2024-12-20T14:30:45.123Z",
  "local": "12/20/2024, 2:30:45 PM",
  "utc": "Fri, 20 Dec 2024 14:30:45 GMT",
  "unix": 1703097845,
  "year": 2024,
  "month": 12,
  "day": 20,
  "hour": 14,
  "minute": 30,
  "second": 45,
  "dayOfWeek": "Friday",
  "timezone": "America/New_York"
}

Desarrollo

Para ejecutar en modo de desarrollo con depuración:

npm run dev

Manejo de Errores

El servidor incluye manejo integral de errores para:

• Zonas horarias no válidas
• Marcas de tiempo no válidas
• Cadenas de formato personalizado mal formadas
• Parámetros obligatorios faltantes

Licencia

Licencia MIT