dev-diary-mcp

Un servidor de Model Context Protocol que convierte una carpeta sencilla de archivos Markdown en un diario de trabajo consultable que cualquier LLM puede leer y escribir.

Sin base de datos. Sin aplicación. Tu registro de trabajo es solo diary/2026-08-22.md (legible por humanos, con soporte de diff y compatible con git), y tu asistente de IA recibe cuatro herramientas para usarlo:

Por qué

«Registrar lo que hice hoy» es la tarea que todo el mundo abandona a la semana. Pero tu asistente de IA ya sabe lo que hiciste: te ayudó a hacerlo. Dale herramientas sobre una carpeta de Markdown y llevar un diario de trabajo se convierte en un subproducto de trabajar con IA.

Ejecutar la demo

El repositorio incluye un cliente MCP real que maneja el servidor de principio a fin (handshake → listTools → llamadas a herramientas), para que puedas verificarlo todo sin un editor:

npm install
npm run build
npm run demo

Salida:

=== 1. listTools ===
 • log_work — Append a timestamped entry...
 • search_diary — Full-text search across every entry...
 • daily_summary — Everything logged on a given date...
 • stats — Totals, active days, streaks, top tags...

=== 2. log_work x3 ===
Logged to 2026-08-22.md at 19:05 (tags: bugfix, websocket)
...

=== 5. stats ===
📊 1 entries across 2 day(s)
🔥 Streak: 2 consecutive day(s)
🏷️ Top tags: #bugfix (1), #websocket (1)

Luego mira diary/*.md: esos son tus datos. Markdown simple.

Conéctalo a tu editor o agente

Claude Desktop / Cursor / cualquier cliente MCP

{
  "mcpServers": {
    "dev-diary": {
      "command": "node",
      "args": ["/absolute/path/to/dev-diary-mcp/dist/server.js"],
      "env": { "DIARY_DIR": "/absolute/path/to/your/diary" }
    }
  }
}

Hermes Agent

hermes mcp add dev-diary --command node --args /path/to/dist/server.js

Inspecciónalo de forma interactiva

npx @modelcontextprotocol/inspector node dist/server.js

El formato de almacenamiento

Un archivo por día (diary/YYYY-MM-DD.md), con las entradas como encabezados H2 con etiquetas integradas:

## 14:32 #bugfix #websocket
Fixed the race condition in the WebSocket broadcast queue

## 16:10 #testing
Wrote E2E test covering two-client sync

Como son solo archivos, puedes hacer grep, hacer copias de seguridad, editarlos a mano o confirmarlos. El servidor lee lo que haya en el disco en cada llamada: no hay caché que invalidar.

Cómo funciona (~190 líneas de TypeScript)

Creado con el SDK oficial @modelcontextprotocol/server (especificación 2026-07-28):

• McpServer + registerTool(name, { description, inputSchema }, handler): los esquemas son Standard Schema; este proyecto usa Zod v4

• StdioServerTransport: el editor lanza el proceso y se comunica por JSON-RPC a través de stdin/stdout

• Los manejadores de herramientas leen y escriben Markdown en DIARY_DIR (por defecto: ./diary)

Artículo complementario: «Construí un servidor MCP que mantiene mi diario de trabajo: todo lo que aprendí» (borrador en este repositorio).

Licencia

MIT