MCP Journaling Server

Servidor de Diario MCP

Un servidor MCP (Protocolo de Control de Mensajes) diseñado para manejar sesiones interactivas de diario con soporte para análisis emocional y guardado automático de conversaciones.

Características

• Gestión automática de sesiones de diario
• Guardado de conversaciones en formato Markdown
• Análisis temporal de conversaciones con marcas de tiempo
• Soporte para leer entradas recientes del diario
• Organización cronológica de entradas del diario

Instalación

Dependiendo de tu cliente MCP, en Claude Desktop:

    "mcpServers": {
        "journaling": {
            "command": "uv",
            "args": [
                "--directory",
                <REPOSITORY PATH>,
                "run",
                "server.py"
            ]
        }
    }

Configuración

El servidor se puede configurar usando variables de entorno en el archivo .env:

• JOURNAL_DIR: Directorio para guardar archivos del diario (predeterminado: ~/Documents/journal)
• FILENAME_PREFIX: Prefijo para nombres de archivo (predeterminado: "journal")
• FILE_EXTENSION: Extensión del archivo del diario (predeterminado: ".md")

Si no se especifican, se usarán los valores predeterminados.

Estructura de Archivos

Las entradas del diario se guardan con la siguiente estructura:

[JOURNAL_DIR]/
├── journal_2025-01-27.md
├── journal_2025-01-26.md
└── ...

Formato de Entrada

Cada entrada del diario incluye:

1. Encabezado con fecha
2. Transcripción de la conversación con marcas de tiempo
3. Análisis emocional
4. Reflexiones y temas recurrentes

API

Herramientas

• start_new_session(): Iniciar una nueva sesión de diario
• record_interaction(user_message, assistant_message): Registrar un intercambio de mensajes
• generate_session_summary(summary): Generar y guardar resumen de sesión
• get_recent_journals(): Recuperar las 5 entradas más recientes

Recursos

• journals://recent: Endpoint para acceder a entradas recientes del diario

Prompts

• start_journaling: Prompt inicial