MCP Datetime

mcp-datetime

English | 日本語

Un servicio de formato de fechas y horas implementado como servidor MCP para la aplicación Claude Desktop. Admite la generación de cadenas de fecha y hora en varios formatos.

Nota: Este paquete solo ha sido probado en macOS. La compatibilidad con Windows no ha sido verificada.

Requisitos previos

Antes de usar mcp-datetime, asegúrate de tener las siguientes herramientas instaladas:

• Python 3.12 o posterior
• uv (instalador de paquetes de Python)
• uvx (ejecutor de paquetes de Python)

Características

• ✨ Soporte para varios formatos de fecha y hora
• 🇯🇵 Soporte para el idioma japonés
• 📁 Formatos optimizados para la generación de nombres de archivo
• 🌏 Manejo preciso de zonas horarias
• 🔧 Integración perfecta con la aplicación Claude Desktop

Componentes del servidor MCP

Herramientas

El servidor implementa una herramienta:

• get_datetime: Obtiene la fecha y hora actuales en varios formatos
  • Toma "format" como argumento de cadena obligatorio
  • Devuelve una cadena de fecha y hora formateada según el formato especificado
  • Admite múltiples tipos de formato, incluidos formatos estándar, japonés e ISO

Uso con la aplicación Claude Desktop

Agrega lo siguiente a tu archivo de configuración:

Ubicación del archivo de configuración (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-datetime": {
      "command": "uvx",
      "args": ["mcp-datetime"]
    }
  }
}

Acerca de la instalación

Si necesitas instalar el paquete directamente (por ejemplo, para desarrollo o inspección del código fuente), puedes usar uno de estos métodos:

• Instalar desde PyPI

  pip install mcp-datetime
  

• Instalar desde el código fuente de GitHub

  git clone https://github.com/ZeparHyfar/mcp-datetime.git
  cd mcp-datetime
  pip install -e .
  

• Ejemplo de claude_desktop_config.json para instalación manual

  {
    "mcpServers": {
      "mcp-datetime": {
        "command": "python",
        "args": ["-m", "mcp_datetime"],
        "env": {
          "PYTHON": "/path/to/your/python"
        }
      }
    }
  }
  

  Reemplaza "/path/to/your/python" con la ruta real de tu intérprete de Python

  p. ej., "/usr/local/bin/python3" o "/Users/username/.pyenv/versions/3.12.0/bin/python3"

Ejemplos básicos

• Formato de comando

  # Standard datetime format
  call datetime-service.get_datetime {"format": "datetime"}
  # Result: 2024-12-10 00:54:01
  
  # Japanese format
  call datetime-service.get_datetime {"format": "datetime_jp"}
  # Result: 2024年12月10日 00時54分01秒
  
  # Filename format
  call datetime-service.get_datetime {"format": "filename_md"}
  # Result: 20241210005401.md
  

• Ejemplos de indicaciones para la aplicación Claude Desktop

  • Usuario

    Please tell me the current time in date_slash format
    

  • Claude

    I'll get the current date in date_slash format.
    
    The current date is 2024/12/12
    

Formatos admitidos

Nombre del formato	Ejemplo	Descripción
date	2024-12-10	Formato de fecha estándar
date_slash	2024/12/10	Fecha con barras
date_jp	2024年12月10日	Formato de fecha japonés
datetime	2024-12-10 00:54:01	Fecha y hora estándar
datetime_jp	2024年12月10日 00時54分01秒	Fecha y hora en japonés
datetime_t	2024-12-10T00:54:01	Fecha y hora con separador T
compact	20241210005401	Formato compacto para IDs
compact_date	20241210	Solo fecha compacta
compact_time	005401	Solo hora compacta
filename_md	20241210005401.md	Nombre de archivo Markdown
filename_txt	20241210005401.txt	Nombre de archivo de texto
filename_log	20241210005401.log	Nombre de archivo de registro
iso	2024-12-10T00:54:01+0900	Formato ISO 8601
iso_basic	20241210T005401+0900	Formato ISO básico
log	2024-12-10 00:54:01.123456	Formato de registro con microsegundos
log_compact	20241210_005401	Formato de registro compacto
time	00:54:01	Solo hora
time_jp	00時54分01秒	Formato de hora japonés

Depuración

Dado que los servidores MCP se ejecutan a través de stdio, la depuración puede ser un desafío. Recomendamos usar el MCP Inspector:

• Usando el paquete de PyPI

  npx @modelcontextprotocol/inspector uvx mcp-datetime
  

• Usando el código fuente descargado de GitHub

  git clone https://github.com/ZeparHyfar/mcp-datetime.git
  npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime
  

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.