log-reflect-mcp

log-reflect-mcp es un servidor MCP local-first para un sistema de registro personal. Proporciona a un cliente de IA una interfaz pequeña y explícita para capturar y recuperar registros en Markdown, manteniendo los registros en un repositorio separado.

Está diseñado para funcionar con las convenciones de directorio utilizadas por log-reflect-practice:

daily/
├── journal/{YYYY}/{YYYYMM}/
└── inputs/{YYYY}/{YYYYMM}/
practices/

Alcance actual

La primera versión expone intencionadamente solo cuatro herramientas:

• capture_journal: crear o añadir un fragmento de diario personal.

• capture_input: guardar una entrada externa como nota en Markdown.

• get_records_by_date_range: recuperar registros de diario y entradas para su revisión.

• search_records: buscar en el contenido de los registros.

El servidor MCP gestiona el acceso y el almacenamiento. Las Agent Skills siguen siendo responsables del criterio: con qué ligereza editar un diario, qué pertenece a una nota de entrada, cómo revisar siete días y cuándo un tema recurrente está listo para convertirse en una Practice.

Related MCP server: ai-journal

Límites de seguridad

• El repositorio fuente no contiene registros personales ni credenciales.

• El servidor solo puede leer daily/journal/ y daily/inputs/.

• Los nuevos registros se escriben únicamente dentro de esos dos directorios.

• Los archivos de entrada existentes nunca se sobrescriben silenciosamente.

• Si existe más de un archivo de diario para una fecha, la escritura se detiene en lugar de adivinar.

Configuración

Requisitos: Node.js 22 o posterior.

npm install
cp .env.example .env

Establece la ruta absoluta a tu repositorio de registros:

RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice

Compila e inicia el servidor stdio:

npm run build
RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice npm start

Ejemplo de configuración de cliente

Después de compilar, apunta un cliente MCP al servidor compilado:

{
  "mcpServers": {
    "log-reflect": {
      "command": "node",
      "args": ["/absolute/path/to/log-reflect-mcp/dist/src/server.js"],
      "env": {
        "RECORDS_REPO_PATH": "/absolute/path/to/log-reflect-practice",
        "RECORDS_TIME_ZONE": "America/Los_Angeles"
      }
    }
  }
}

Desarrollo

npm run check
npm test

Para inspeccionar las herramientas de forma interactiva:

npx @modelcontextprotocol/inspector node dist/src/server.js

Hoja de ruta

• Añadir recursos MCP para leer registros individuales.

• Añadir indicaciones de revisión y desarrollo de practices sin trasladar el criterio al código de almacenamiento.

• Añadir un flujo de trabajo de confirmación Git opcional.

• Añadir un adaptador de almacenamiento respaldado por GitHub.

• Añadir Streamable HTTP y OAuth solo después de que el flujo de trabajo local sea estable.