Chronos Protocol

Un servidor MCP robusto que elimina la ceguera temporal en agentes de codificación de IA mediante seguimiento inteligente del tiempo, memoria persistente y trazabilidad completa de sesiones.

GitHub

Prueba este MCPPatrocinado

Documentación

Protocolo Chronos

Servidor MCP que proporciona inteligencia temporal, memoria persistente y trazabilidad completa para agentes de codificación de IA.

El Protocolo Chronos transforma los flujos de trabajo de desarrollo de IA al eliminar la ceguera temporal en los sistemas automatizados. El servidor MCP proporciona trazabilidad completa y continuidad de sesión, lo que permite a los agentes de IA mantener el contexto entre sesiones mientras ofrece seguimiento de tiempo de nivel empresarial, programación inteligente y análisis de desarrollo integral.

Antecedentes

Capacidades Principales

El Protocolo Chronos aborda brechas críticas en los flujos de trabajo de desarrollo de IA mediante inteligencia temporal sofisticada y sistemas de memoria persistente diseñados específicamente para entornos de codificación automatizados.

Enfoque de Hora del Sistema Primero

El Protocolo Chronos transforma cómo los sistemas automatizados manejan el tiempo al priorizar la hora del sistema local de tu computadora como el valor predeterminado inteligente. Sin más confusión de zonas horarias: solo usa "system" o "local" y obtén conciencia temporal instantánea y contextual que se adapta a tu entorno.

Inteligencia Temporal Principal

get_current_time - Conciencia Temporal Simplificada

El Protocolo Chronos prioriza la hora del sistema local de tu computadora como el valor predeterminado inteligente. La mayoría de los IDE de IA ya incorporan la hora del sistema en sus indicaciones, pero el Protocolo Chronos proporciona contexto temporal explícito y estructurado que funciona en todos los clientes MCP.

Obtén marcas de tiempo estandarizadas con contexto de hora del sistema:

Prioridad de Hora del Sistema: Usa la hora del sistema local como valor predeterminado inteligente
Colaboración entre Zonas Horarias: Muestra la hora local junto con la zona horaria del equipo para proyectos globales
Contexto Temporal: Los agentes de IA siempre saben "cuándo" están operando para una mejor toma de decisiones

convert_time - Traducción Inteligente de Zonas Horarias

Elimina errores de cálculo de zonas horarias con conversión inteligente:

Programación de Reuniones: Convierte horas entre zonas horarias globales
Planificación de Lanzamientos: Coordina despliegues entre regiones
Análisis de Diferencia Horaria: Calcula desfases de zonas horarias con manejo de horario de verano

Sistema de Inteligencia de Actividades

start_activity_log - Inicialización Inteligente de Contexto

Inicia un monitoreo sofisticado de actividades con IDs de Actividad únicos y metadatos enriquecidos para flujos de trabajo de desarrollo agénticos:

Gestión de Sesiones Autónomas: Rastrea sesiones de codificación, procesos de depuración e implementaciones de funciones con contexto persistente
Análisis Inteligente de Tareas: Monitorea y aprende de patrones de finalización de tareas para optimizar la planificación futura
Preservación de Contexto: Mantén registros precisos para la continuidad entre sesiones y la reanudación fluida de tareas

end_activity_log - Documentación de Éxito y Analítica

Completa actividades con cálculo automático de duración y datos de resultados enriquecidos para inteligencia de rendimiento:

Análisis de Auto-Rendimiento: Analiza tiempos de finalización reales vs. estimados para una mejor precisión en la planificación futura
Documentación Autónoma: Documenta logros y lecciones aprendidas para la retención persistente de conocimiento
Rendimiento Adaptativo: Construye inteligencia histórica sobre la velocidad de desarrollo y patrones de éxito

get_elapsed_time - Monitoreo de Progreso en Tiempo Real

Monitorea actividades en curso sin interrumpir el flujo de ejecución:

Gestión de Tareas de Larga Duración: Verifica el progreso en depuraciones extendidas o implementaciones complejas
Bloqueo de Tiempo Inteligente: Monitorea y optimiza sesiones de trabajo para máxima eficiencia
Conciencia de Contexto: Rastrea la duración de diferentes fases en procesos de resolución de problemas

get_activity_logs - Inteligencia Histórica y Análisis de Patrones

Consulta y analiza patrones de desarrollo con filtrado sofisticado:

Reconocimiento Autónomo de Patrones: Genera informes de rendimiento e identifica oportunidades de optimización
Analítica de Auto-Aprendizaje: Identifica qué tipos de tareas requieren más recursos y adapta el enfoque en consecuencia
Aprendizaje entre Proyectos: Aprovecha la experiencia de diferentes proyectos para mejorar la efectividad general

update_activity_log - Gestión Inteligente de Actividades

Modifica actividades completadas con conocimientos actualizados y correcciones:

Aprendizaje Autónomo: Agrega conocimientos descubiertos después de la finalización de la tarea para referencia futura
Auto-Corrección: Corrige errores de tiempo o actualiza descripciones de tareas según nueva información
Documentación Continua: Actualiza resultados y aprendizajes a medida que los proyectos evolucionan y surge nuevo contexto

Sistema Inteligente de Recordatorios

create_time_reminder - Programación Contextual de Tareas

Establece recordatorios inteligentes vinculados a tu flujo de trabajo de desarrollo:

Seguimientos de Revisión de Código: Nunca olvides verificar solicitudes de extracción pendientes
Actualizaciones de Dependencias: Programa verificaciones regulares de paquetes desactualizados y parches de seguridad
Puntos de Control de Lanzamientos: Establece recordatorios para ventanas de despliegue, prueba y reversión

check_time_reminders - Sistema de Conciencia Proactiva

Mantente por delante de tareas importantes con detección inteligente de recordatorios:

Plazos Próximos: Obtén aviso anticipado de hitos de proyecto que se acercan
Ventanas de Mantenimiento: Recibe recordatorios de mantenimiento programado del sistema o despliegues
Coordinación de Equipo: Nunca te pierdas sesiones colaborativas o verificaciones importantes

Declaración del Problema

Resuelve Problemas Reales

Elimina la Ceguera Temporal de la IA: Tus agentes de IA pueden verificar activamente la hora actual y tomar decisiones conscientes del tiempo en lugar de depender únicamente de la hora del sistema incorporada en su Indicación del Sistema
Reduce el Cambio de Contexto: Los agentes de IA pueden rastrear el tiempo sin interrumpir tu flujo
Continuidad entre Proyectos: Comienza el seguimiento en el Proyecto A, termina en el Proyecto B: todo permanece conectado
Diseño Centrado en el Desarrollador: Construido específicamente para flujos de trabajo de codificación agénticos, no para seguimiento de tiempo genérico

Arquitectura

Arquitectura de Almacenamiento Flexible

El Protocolo Chronos admite modos de almacenamiento duales para adaptarse a tu flujo de trabajo de desarrollo:

Modo Centralizado (Tradicional)

Base de datos única para todos los proyectos
Analítica entre proyectos e inteligencia histórica
Ideal para: Equipos que desean seguimiento de tiempo unificado en todo el trabajo
Integración con Marcos de IA: La memoria persistente funciona en todos los proyectos

Modo por Proyecto (Dinámico)

Detección automática de proyectos con configuración cero
Almacenamiento aislado por proyecto ({project-root}/chronos-data/time_server_data.json)
Ideal para: Desarrolladores individuales que prefieren seguimiento específico por proyecto
Configuración Cero: Solo usa --storage-mode per-project y funciona en todas partes

Integración con el Marco de Ingeniería de Contexto

El sistema de registro de actividades del Protocolo Chronos proporciona memoria persistente para marcos de IA como Claude Task Master, Agent OS y Método BMAD, lo que permite un seguimiento mejorado de tareas, registro centralizado de actividades y análisis histórico con IDs de Actividad persistentes en las operaciones de agentes.

Guía de Integración: Para agentes de codificación de IA, consulta la plantilla de indicación de muestra en AGENTS.md que proporciona Reglas de Cursor que se pueden integrar con tus reglas de flujo de trabajo existentes. Esta plantilla demuestra el protocolo completo de registro de actividades con patrones de nombres de archivos de listas de tareas personalizables.

Beneficios de la Memoria Persistente

Continuidad entre Sesiones: Las tareas iniciadas en una sesión se pueden rastrear y completar en otra
Almacenamiento Agnóstico al Marco: La base de datos JSON funciona con cualquier marco de IA que pueda agregar IDs de Actividad
Preservación de Contexto Enriquecido: Metadatos completos de actividad, incluidos duración, resultados y etiquetas personalizadas
Inteligencia Histórica: Los marcos de IA pueden consultar actividades pasadas para reconocimiento de patrones y optimización

Instalación

Requisitos Previos

Python: 3.10 o superior
Soporte MCP: Cliente de IA con soporte de Protocolo de Contexto de Modelo

Pasos de Instalación

# 1. Clone the repository
git clone https://github.com/n0zer0d4y/chronos-protocol.git
cd chronos-protocol

# 2. Install dependencies
pip install -r requirements.txt

# 3. Install in editable mode (required for MCP)
pip install -e .

# 4. Verify installation
python -m chronos_protocol --help

Después de la instalación, configura el Protocolo Chronos en tu cliente MCP usando el esquema de configuración apropiado en la sección Configuración.

Uso

Operaciones Básicas de Inteligencia Temporal

Obtener Hora Actual con Contexto

# Get current time in your system's timezone
get_current_time(timezone="system")
# Returns: Current time with full timezone context

Conversión Inteligente de Zonas Horarias

# Convert meeting time across timezones
convert_time(
  source_timezone="America/New_York",
  time="15:00",
  target_timezone="Europe/London"
)
# Returns: Converted time with timezone difference

Flujo de Trabajo de Inteligencia de Actividades

Seguimiento Completo de Sesiones de Desarrollo

# 1. Start activity logging
activity_id = start_activity_log(
    activityType="debugging",
    task_scope="feature-implementation",
    description="Fix authentication module login flow"
)

# 2. AI agent works on the task...
# Monitor progress with get_elapsed_time(activity_id)

# 3. Complete with results
end_activity_log(
    activity_id,
    result="Authentication module completed successfully"
)

Análisis Inteligente de Tareas

# Get activity history for pattern analysis
activities = get_activity_logs(
    activityType="debugging",
    task_scope="feature-implementation"
)

# AI learns from patterns and timing
for activity in activities:
    analyze_completion_time(activity)
    identify_successful_patterns(activity)

Continuidad entre Sesiones

# Check for ongoing activities
ongoing = get_activity_logs(status="ongoing")
if ongoing:
    # Resume where you left off
    continue_activity(ongoing[0]["activityId"])

# Learning from history
debug_sessions = get_activity_logs(
    activityType="debugging",
    start_date="2024-01-01"
)

Ejemplo de Integración con Marcos de IA

# Example: AI Framework Integration
activity_id = start_activity_log(
    activityType="framework_task",
    task_scope="feature-implementation",
    description="AI agent implementing authentication module",
    tags=["ai-agent", "claude-task-master"]
)

# Your framework stores the activity_id with task data
# Later: end_activity_log(activity_id, result="Authentication module completed")

¡Esto crea un bucle de retroalimentación inteligente donde los marcos de IA aprenden del rendimiento histórico de tareas y patrones de tiempo!

API

Funciones de Inteligencia Temporal

`get_current_time(timezone)`

Obtén marcas de tiempo estandarizadas con contexto de hora del sistema.

Parámetros:

timezone (cadena): Zona horaria objetivo. Usa "system" o "local" para la hora local del usuario, o nombres IANA como "America/New_York", "Europe/London", "UTC"

Devuelve: Hora actual con contexto completo de zona horaria y metadatos

`convert_time(source_timezone, time, target_timezone)`

Convierte la hora entre zonas horarias con manejo inteligente del horario de verano.

Parámetros:

source_timezone (cadena): Zona horaria de origen
time (cadena): Hora en formato de 24 horas (HH:MM)
target_timezone (cadena): Zona horaria objetivo

Devuelve: Hora convertida con información de diferencia de zona horaria

Funciones de Inteligencia de Actividades

`start_activity_log(activityType, task_scope, description, tags?)`

Inicializa el monitoreo de actividades con ID de Actividad único y metadatos enriquecidos.

Parámetros:

activityType (cadena): Tipo de actividad (p. ej., 'depuración', 'implementación-de-funciones')
task_scope (cadena): Alcance de la tarea de las opciones predefinidas
description (cadena): Descripción detallada de la actividad
tags (matriz, opcional): Matriz de cadenas para categorizar la actividad

Devuelve: ID de Actividad único para seguimiento

`end_activity_log(activityId, result?, notes?)`

Completa la actividad con cálculo automático de duración y datos de resultados enriquecidos.

Parámetros:

activityId (cadena): Identificador único de la actividad a finalizar
result (cadena, opcional): Resultado o desenlace de la actividad
notes (cadena, opcional): Notas adicionales sobre la actividad

Devuelve: Actividad completada con duración y marcas de tiempo

`get_elapsed_time(activityId)`

Monitorea actividades en curso sin interrumpir el flujo de ejecución.

Parámetros:

activityId (cadena): Identificador único de la actividad

Devuelve: Información de tiempo transcurrido para la actividad especificada

`get_activity_logs(filters?)`

Consulta y analiza patrones de desarrollo con filtrado sofisticado.

Parámetros:

filters (objeto, opcional): Opciones de filtrado que incluyen:
- activityType (cadena): Filtrar por tipo de actividad
- task_scope (cadena): Filtrar por alcance de tarea
- startDate (cadena): Filtrar por fecha de inicio (formato ISO 8601)
- endDate (cadena): Filtrar por fecha de finalización (formato ISO 8601)
- limit (entero): Número máximo de registros a devolver

Devuelve: Matriz de registros de actividad que coinciden con los criterios

`update_activity_log(activityId, updates)`

Modifica actividades completadas con conocimientos actualizados y correcciones.

Parámetros:

activityId (cadena): Identificador único de la actividad a actualizar
updates (objeto): Objeto que contiene los campos a actualizar

Devuelve: Registro de actividad actualizado

Funciones del Sistema de Recordatorios

`create_time_reminder(reminderTime, message, relatedTaskId?)`

Crea un recordatorio basado en tiempo usando la hora del sistema para la programación.

Parámetros:

reminderTime (cadena): Hora para el recordatorio (formato ISO 8601 con zona horaria)
message (cadena): Mensaje del recordatorio
relatedTaskId (cadena, opcional): ID de la tarea o actividad relacionada Devuelve: Recordatorio creado con identificador único

`check_time_reminders(upcomingMinutes?)`

Comprueba recordatorios de tiempo vencidos o próximos.

Parámetros:

upcomingMinutes (entero, opcional): Comprueba recordatorios que vencen dentro de este número de minutos (predeterminado: 60)

Devuelve: Matriz de recordatorios vencidos y próximos

Configuración

Chronos Protocol admite dos modos de almacenamiento:

Modo	Caso de uso	Ubicación de datos
Por proyecto	Aislamiento de proyectos individuales	`{project-root}/chronos-data/time_server_data.json`
Centralizado	Análisis entre proyectos	Directorio personalizado mediante `--data-dir`

Opciones de formato de ID

Formato	Ejemplo	Longitud	Caso de uso
`custom`	`28RCD6M8A64P`	12 caracteres	Ultracompacto para listas de tareas
`short`	`vytxeTZskVKR7C7WgdSP3d`	22 caracteres	Legibilidad equilibrada
`uuid`	`bb401d9e-1c3e-41d4-a201-733baa48c13d`	36 caracteres	Compatibilidad heredada

Importante: Advertencia sobre el parámetro de tipo

NO agregues "type": "stdio" a tu configuración de MCP.

Por qué esto causa fallos:

Chronos Protocol está codificado para usar transporte stdio
Cuando los clientes agregan "type": "stdio", puede interferir con la resolución de variables
La sustitución de variables ocurre antes de la validación de tipos
Resulta en rutas inválidas como C:\Program Files\VSCode\${workspaceFolder}

Enfoque correcto:

Deja que Chronos Protocol maneje la selección de transporte automáticamente
Solo especifica "type" si tu cliente MCP lo requiere Y no estás usando variables
La mayoría de los clientes MCP funcionan perfectamente sin declaración explícita de tipo

Extensiones de VS Code y bifurcaciones

Extensión Roo Code

{
  "mcpServers": {
    "chronos-protocol": {
      "command": "python",
      "args": [
        "-m",
        "chronos_protocol",
        "--storage-mode",
        "per-project",
        "--project-root",
        "${workspaceFolder}",
        "--id-format",
        "custom"
      ]
    }
  }
}

Bifurcaciones de VS Code

Cursor y Trae

{
  "mcpServers": {
    "chronos-protocol": {
      "command": "python",
      "args": [
        "-m",
        "chronos_protocol",
        "--storage-mode",
        "per-project",
        "--project-root",
        "${workspaceFolder}",
        "--id-format",
        "custom"
      ]
    }
  }
}

Clientes CLI

Claude Code y Gemini CLI

{
  "chronos-protocol": {
    "command": "python",
    "args": [
      "-m",
      "chronos_protocol",
      "--storage-mode",
      "per-project",
      "--id-format",
      "custom"
    ]
  }
}

Clientes con soporte limitado

Cline y Qoder

Limitaciones conocidas:

No admite la sustitución de variables ${workspaceFolder}
No puede usar el modo de almacenamiento por proyecto
Fallará si se incluye el argumento --project-root
Limitado solo al almacenamiento centralizado

Configuración de trabajo:

{
  "chronos-protocol": {
    "disabled": false,
    "timeout": 60,
    "command": "python",
    "args": [
      "-m",
      "chronos_protocol",
      "--storage-mode",
      "centralized",
      "--data-dir",
      "/path/to/centralized/chronos-data",
      "--id-format",
      "custom"
    ]
  }
}

NO agregues:

--project-root "${workspaceFolder}" (causa fallos)
parámetro "type": "stdio" (consulta la sección Importante anterior)

Importante: Advertencia sobre el parámetro de tipo

NO agregues "type": "stdio" a tu configuración de MCP

Por qué esto causa fallos:

Chronos Protocol está codificado para usar transporte stdio
Cuando los clientes agregan "type": "stdio", puede interferir con la resolución de variables
La sustitución de variables ocurre antes de la validación de tipos
Resulta en rutas inválidas como C:\Program Files\VSCode\${workspaceFolder}

Enfoque correcto:

Deja que Chronos Protocol maneje la selección de transporte automáticamente
Solo especifica "type" si tu cliente MCP lo requiere Y no estás usando variables
La mayoría de los clientes MCP funcionan perfectamente sin declaración explícita de tipo

Solución de problemas

Problemas comunes

Error "No hay herramientas ni indicaciones"

Síntomas:

El servidor MCP parece estar conectado
Las herramientas no están disponibles en el cliente
No hay mensajes de error visibles

Soluciones por cliente:

Cursor:

Asegúrate de que --project-root "${workspaceFolder}" esté incluido
Verifica que el espacio de trabajo esté abierto correctamente

Claude Code:

Elimina el argumento --project-root (usa la detección predeterminada)
No agregues el parámetro "type": "stdio"

Cline/Qoder:

Usa el modo de almacenamiento centralizado
Elimina todas las variables del espacio de trabajo
Establece una ruta explícita --data-dir

Problemas de sustitución de variables

Problema: ${workspaceFolder} no se resuelve Clientes afectados: Cline, Qoder, algunas configuraciones de Claude Code

Solución:

{
  "chronos-protocol": {
    "command": "python",
    "args": [
      "-m",
      "chronos_protocol",
      "--storage-mode",
      "centralized",
      "--data-dir",
      "/explicit/path/to/chronos-data"
    ]
  }
}

Errores de permisos de almacenamiento

Error: No se puede crear el directorio chronos-data Solución:

Asegúrate de tener permisos de escritura en el directorio del proyecto
Para el modo por proyecto, verifica los permisos del espacio de trabajo
Para el modo centralizado, verifica la accesibilidad de --data-dir

Módulo de Python no encontrado

Error: ModuleNotFoundError: No module named 'chronos_protocol' Solución:

# Ensure editable installation
pip install -e .
   # Verify installation
python -m chronos_protocol --help

Problemas específicos del cliente

Extensiones de VS Code

Asegúrate de que la extensión MCP esté habilitada
Verifica la compatibilidad de la versión de VS Code
Verifica que el espacio de trabajo esté abierto correctamente

Bifurcaciones de VS Code

Algunas bifurcaciones pueden tener implementaciones MCP personalizadas
Consulta la documentación específica de la bifurcación
Informa problemas a los mantenedores de la bifurcación

Clientes CLI

Asegúrate de tener un formato JSON correcto
Verifica los permisos de archivo para los archivos de configuración
Verifica la configuración del entorno de Python

Optimización del rendimiento

Registros de actividad grandes

Usa el formato de ID adecuado para tu caso de uso
Considera el almacenamiento centralizado para análisis entre proyectos
Archiva actividades antiguas periódicamente

Uso de memoria

El modo por proyecto aísla el uso de memoria
El modo centralizado puede acumular datos con el tiempo
Supervisa los tamaños de los directorios de almacenamiento

Obtener ayuda

Soporte de la comunidad

Revisa los problemas de GitHub para problemas similares
Proporciona registros de error detallados y configuración
Incluye la versión del cliente e información de la plataforma

Información de depuración

# Get detailed server logs
python -m chronos_protocol --verbose

# Check MCP client logs
# (varies by client - check client documentation)

Contribuciones

Configuración de desarrollo

# Fork and clone
git clone https://github.com/n0zer0d4y/chronos-protocol.git
cd chronos-protocol

# Set up development environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
pip install -e .

# Run tests
pytest tests/

# Run with debug logging
python -m chronos_protocol --debug

Estándares de código

Python: Sigue las pautas de estilo PEP 8
Documentación: Usa docstrings estilo Google
Pruebas: Mantén una cobertura de pruebas >90%
Commits: Usa el formato de commit convencional

Pruebas de clientes MCP

Al agregar soporte para nuevos clientes MCP:

Prueba con ambos modos de almacenamiento
Verifica que todas las herramientas funcionen correctamente
Revisa los escenarios de manejo de errores
Actualiza la documentación de configuración
Agrega a la matriz de compatibilidad

Informar errores

Plantilla de informe de errores:

Nombre y versión del cliente MCP
Configuración utilizada
Comportamiento esperado vs. real
Registros de error (si están disponibles)
Pasos para reproducir

Licencia

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

Agradecimientos

Anthropic por la especificación del Protocolo de Contexto de Modelo
Comunidad MCP por las implementaciones de clientes y las pruebas
Contribuyentes por sus valiosos comentarios e informes de errores

¿Listo para transformar tu flujo de trabajo de desarrollo de IA? Configura Chronos Protocol en tu cliente MCP y comienza a construir con trazabilidad completa y continuidad de sesión.