dev-diary-mcp

Ein Model Context Protocol-Server, der einen einfachen Ordner mit Markdown-Dateien in ein durchsuchbares Arbeitstagebuch verwandelt, das jedes LLM lesen und schreiben kann.

Keine Datenbank. Keine App. Ihr Arbeitstagebuch ist einfach diary/2026-08-22.md — menschenlesbar, diffbar, git-freundlich — und Ihr KI-Assistent erhält vier Tools, um es zu nutzen:

Warum

„Was ich heute gemacht habe" zu protokollieren ist die Aufgabe, die alle nach einer Woche aufgeben. Aber Ihr KI-Assistent weiß bereits, was Sie getan haben — er hat Ihnen dabei geholfen. Geben Sie ihm Tools für einen Markdown-Ordner, und das Führen eines Arbeitstagebuchs wird zum Nebenprodukt der Arbeit mit KI.

Demo ausführen

Das Repo enthält einen echten MCP-Client, der den Server end-to-end steuert (Handshake → listTools → Tool-Aufrufe), sodass Sie alles ohne Editor überprüfen können:

npm install
npm run build
npm run demo

Ausgabe:

=== 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)

Dann schauen Sie in diary/*.md — das sind Ihre Daten. Reines Markdown.

Verbinden Sie es mit Ihrem Editor / Agenten

Claude Desktop / Cursor / jeder MCP-Client

{
  "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

Interaktiv prüfen

npx @modelcontextprotocol/inspector node dist/server.js

Das Speicherformat

Eine Datei pro Tag (diary/YYYY-MM-DD.md), Einträge als H2-Überschriften mit eingebetteten Tags:

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

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

Da es sich nur um Dateien handelt, können Sie sie mit grep durchsuchen, sichern, von Hand bearbeiten oder committen. Der Server liest bei jedem Aufruf, was auf der Festplatte liegt — kein Cache, der ungültig gemacht werden müsste.

So funktioniert es (~190 Zeilen TypeScript)

Erstellt mit dem offiziellen @modelcontextprotocol/server SDK (2026-07-28-Spezifikation):

• McpServer + registerTool(name, { description, inputSchema }, handler) — Schemas sind Standard Schema; dieses Projekt verwendet Zod v4

• StdioServerTransport — der Editor startet den Prozess und spricht JSON-RPC über stdin/stdout

• Tool-Handler lesen/schreiben Markdown unter DIARY_DIR (Standard: ./diary)

Begleitartikel: „Ich habe einen MCP-Server gebaut, der mein Arbeitstagebuch führt — hier ist alles, was ich gelernt habe" (Entwurf in diesem Repo).

Lizenz

MIT