MCP Journaling Server

Servidor de Diário MCP

Um servidor MCP (Message Control Protocol) projetado para lidar com sessões interativas de diário, com suporte para análise emocional e salvamento automático de conversas.

Recursos

• Gerenciamento automático de sessões de diário
• Salvamento de conversas em formato Markdown
• Análise temporal de conversas com carimbos de data/hora
• Suporte para leitura de entradas recentes do diário
• Organização cronológica das entradas do diário

Instalação

Dependendo do seu cliente MCP, no Claude Desktop:

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

Configuração

O servidor pode ser configurado usando variáveis de ambiente no arquivo .env:

• JOURNAL_DIR: Diretório para salvar arquivos do diário (padrão: ~/Documents/journal)
• FILENAME_PREFIX: Prefixo para nomes de arquivo (padrão: "journal")
• FILE_EXTENSION: Extensão do arquivo do diário (padrão: ".md")

Se não forem especificados, os valores padrão serão usados.

Estrutura de Arquivos

As entradas do diário são salvas com a seguinte estrutura:

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

Formato da Entrada

Cada entrada do diário inclui:

1. Cabeçalho com data
2. Transcrição da conversa com carimbos de data/hora
3. Análise emocional
4. Reflexões e temas recorrentes

API

Ferramentas

• start_new_session(): Iniciar uma nova sessão de diário
• record_interaction(user_message, assistant_message): Registrar uma troca de mensagens
• generate_session_summary(summary): Gerar e salvar resumo da sessão
• get_recent_journals(): Recuperar as 5 entradas mais recentes

Recursos

• journals://recent: Endpoint para acessar entradas recentes do diário

Prompts

• start_journaling: Prompt inicial