MCP Time Server

Un servidor simple que proporciona la hora UTC actual.

GitHub

Documentación

Servidor de Tiempo MCP

Un servidor simple del Protocolo de Contexto de Modelo (MCP) que proporciona funcionalidad de hora UTC actual. Este servidor puede integrarse globalmente con Cursor IDE para proporcionar capacidades relacionadas con el tiempo en todos los proyectos.

Características

  • Obtener la hora UTC actual en múltiples formatos
  • Implementación simple del protocolo MCP
  • Integración global con Cursor IDE
  • Ligero y rápido

Instalación

Requisitos previos

  • Python 3.8 o superior
  • Gestor de paquetes pip

Instalar desde el código fuente

  1. Clona o descarga este repositorio
  2. Navega al directorio del proyecto
  3. Instala el paquete:
pip install -e .

Instalar solo las dependencias

pip install -r requirements.txt

Uso

Ejecutar el servidor

# Run directly
python -m mcp_time_server.server

# Or use the installed script
mcp-time-server

Herramientas disponibles

get_current_time_utc

Obtiene la hora UTC actual en varios formatos.

Parámetros:

  • format (opcional): Formato de salida
    • "iso" (predeterminado): Formato ISO 8601 (2025-01-15T10:30:45Z)
    • "datetime": Formato legible para humanos (2025-01-15 10:30:45)
    • "timestamp": Marca de tiempo Unix (1736939445)

Ejemplo de respuesta:

Current UTC time: 2025-01-15T10:30:45.123456Z
Format: iso
Full ISO: 2025-01-15T10:30:45.123456Z

Integración con Cursor IDE

Configuración global (recomendada)

Para integración permanente en todos los proyectos:

  1. Crea el archivo de configuración global de MCP:

    • Windows: C:\Users\[USERNAME]\.cursor\mcp.json
    • macOS/Linux: ~/.cursor/mcp.json

  2. Añade la siguiente configuración:

{
  "mcpServers": {
    "time-server": {
      "command": "python",
      "args": ["-m", "mcp_time_server.server"],
      "cwd": "/full/path/to/mcp-time-server/src",
      "env": {
        "PYTHONPATH": "/full/path/to/mcp-time-server/src"
      }
    }
  }
}
  1. Reinicia Cursor IDE
  2. Verifica Tools & Integrations > MCP para confirmar que el servidor está habilitado

¡El servidor ahora se iniciará automáticamente con Cursor IDE y funcionará en todos los proyectos!

Configuración específica del proyecto

Para uso solo en un proyecto, crea .cursor/mcp.json en el directorio de tu proyecto con la misma estructura.

Desarrollo

Configuración de desarrollo

# Install with development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/
isort src/

# Type checking
mypy src/

Estructura del proyecto

mcp-time-server/
├── src/
│   └── mcp_time_server/
│       ├── __init__.py
│       └── server.py
├── pyproject.toml
├── requirements.txt
├── README.md
├── mcp_config.json
└── PROJECT_PLAN.md

Pruebas

Prueba la funcionalidad del servidor:

from mcp_time_server.server import get_current_time_utc

# Test different formats
print(get_current_time_utc("iso"))
print(get_current_time_utc("datetime"))
print(get_current_time_utc("timestamp"))

Solución de problemas

Problemas comunes

  1. Errores de importación: Asegúrate de que el paquete esté instalado con pip install -e .
  2. Problemas de conexión MCP: Verifica la ruta del servidor en tu configuración de MCP
  3. Errores de permisos: Asegúrate de que Python tenga los permisos necesarios para ejecutar el servidor
  4. El servidor no aparece: Comprueba que el directorio .cursor exista y que mcp.json tenga el formato correcto

Windows PowerShell

Si encuentras problemas con el operador && en PowerShell, usa:

cd src; python -m mcp_time_server.server

Verificación del estado del servidor

Comprueba si el servidor está en ejecución:

# Windows
tasklist | findstr python
wmic process where "name='python.exe'" get ProcessId,CommandLine /format:list

# macOS/Linux  
ps aux | grep mcp_time_server

Prueba la conexión en Cursor: Pide al asistente de IA que obtenga la hora actual: debería usar el Servidor de Tiempo MCP automáticamente.

Gestión manual del servidor

Iniciar el servidor manualmente:

cd src && python -m mcp_time_server.server

Detener el servidor:

# Windows (replace PID with actual process ID)
taskkill /PID [PID] /F

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de funcionalidad
  3. Realiza tus cambios
  4. Añade pruebas si corresponde
  5. Envía una solicitud de extracción

Registro de cambios

v0.1.0

  • Versión inicial
  • Funcionalidad básica de hora UTC
  • Cumplimiento del protocolo MCP
  • Integración de FastMCP para gestión simplificada del servidor
  • Soporte de configuración global de Cursor IDE
  • Múltiples formatos de hora (ISO, datetime, timestamp)
  • Pruebas y documentación exhaustivas
  • Herramientas de gestión de procesos y solución de problemas
  • Repositorio de GitHub con licencia MIT
  • Pruebas en vivo confirmadas en ciclos de reinicio