log-reflect-mcp

log-reflect-mcp ist ein lokaler MCP-Server für ein persönliches Aufzeichnungssystem. Er bietet einem KI-Client eine kleine, explizite Schnittstelle zum Erfassen und Abrufen von Markdown-Aufzeichnungen, während die Aufzeichnungen in einem separaten Repository gespeichert bleiben.

Er ist für die Verwendung mit den Verzeichniskonventionen von log-reflect-practice konzipiert:

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

Aktueller Umfang

Die erste Version stellt bewusst nur vier Tools bereit:

• capture_journal: ein persönliches Journal-Fragment erstellen oder anhängen.

• capture_input: einen externen Input als Markdown-Notiz speichern.

• get_records_by_date_range: Journal- und Input-Aufzeichnungen zur Überprüfung abrufen.

• search_records: Aufzeichnungsinhalte durchsuchen.

Der MCP-Server übernimmt Zugriff und Speicherung. Agent Skills bleiben für die Beurteilung zuständig: wie behutsam ein Journal bearbeitet wird, was in eine Input-Notiz gehört, wie sieben Tage überprüft werden und wann ein wiederkehrendes Thema bereit ist, eine Practice zu werden.

Related MCP server: ai-journal

Sicherheitsgrenzen

• Das Quell-Repository enthält keine persönlichen Aufzeichnungen oder Zugangsdaten.

• Der Server kann nur daily/journal/ und daily/inputs/ lesen.

• Neue Aufzeichnungen werden nur innerhalb dieser beiden Verzeichnisse geschrieben.

• Vorhandene Input-Dateien werden niemals stillschweigend überschrieben.

• Wenn für ein Datum mehr als eine Journal-Datei existiert, wird der Schreibvorgang gestoppt, statt zu raten.

Einrichtung

Voraussetzungen: Node.js 22 oder neuer.

npm install
cp .env.example .env

Legen Sie den absoluten Pfad zu Ihrem Aufzeichnungs-Repository fest:

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

Erstellen und starten Sie den stdio-Server:

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

Beispiel-Client-Konfiguration

Nach dem Erstellen zeigen Sie einen MCP-Client auf den kompilierten Server:

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

Entwicklung

npm run check
npm test

Um die Tools interaktiv zu inspizieren:

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

Roadmap

• MCP-Ressourcen zum Lesen einzelner Aufzeichnungen hinzufügen.

• Review- und Develop-Practice-Prompts hinzufügen, ohne die Beurteilung in Speichercode zu verlagern.

• Einen optionalen Git-Commit-Workflow hinzufügen.

• Einen GitHub-gestützten Speicheradapter hinzufügen.

• Streamable HTTP und OAuth erst hinzufügen, wenn der lokale Workflow stabil ist.