MarkScribe

Konventionsbewusster Markdown-MCP-Server für das Model Context Protocol. MarkScribe ermöglicht es KI-Agenten, Markdown-Dateien zu lesen, zu schreiben, zu durchsuchen und zu validieren – und setzt dabei Konventionen durch benutzerdefinierte YAML-Schemas durch. Funktioniert mit jedem Markdown-Verzeichnis: Obsidian-Vaults, Foam-Workspaces, Digital Gardens, Dokumentations-Repos.

Funktionen

• Notizen lesen, schreiben, verschieben und löschen mit atomaren Dateioperationen

• Volltextsuche (BM25-Ranking) über Inhalte und Frontmatter hinweg

• Wikilink-bewusst: Backlinks, Erkennung defekter Links, Auffinden von Waisen, Entdeckung nicht verlinkter Erwähnungen

• YAML-Frontmatter-Parsing, Validierung und Massenaktualisierungen

• Tag-Verwaltung (Frontmatter und Inline)

• Konventionsdurchsetzung mittels Schemas – Notiz-Schemas validieren Frontmatter/Inhalt, Ordner-Schemas erzwingen strukturelle Regeln

• Konventionskaskade: _conventions.md-Dateien weisen Schemas Verzeichnis-Unterbäumen zu

• Pfadsicherheit: .obsidian/, .git/, node_modules/ sind immer blockiert

Related MCP server: mcp-obsidian

Installation

npm install -g markscribe

Verwendung

Als MCP-Server

{
 "mcpServers": {
 "markscribe": {
 "command": "markscribe",
 "args": ["--root", "/path/to/your/notes"]
 }
 }
}

CLI-Flags

Verzeichnisspezifische Konfiguration

Platzieren Sie eine .markscribe/config.yaml in Ihrem Stammverzeichnis:

paths:
 blocked:
 - private/
 - drafts/
 allowed_extensions:
 - .md
 - .markdown
 - .txt
search:
 max_results: 50
 excerpt_chars: 40

Schemas

Schemas definieren Konventionen für Ihre Notizen und Ordner. Platzieren Sie diese in Ihrem Schema-Verzeichnis (standardmäßig ~/.markscribe/schemas/).

Notiz-Schema – validiert Frontmatter-Felder und Inhaltsregeln:

name: blog-post
description: Blog post with required metadata
type: note
frontmatter:
 fields:
 title:
 type: string
 required: true
 tags:
 type: list
 required: true
content:
 rules:
 - name: has-outgoing-link
 check: hasPattern
 pattern: "\\[\\[.+?\\]\\]"

Ordner-Schema – erzwingt strukturelle Regeln für Verzeichnisse:

name: project-folder
description: Project folder with hub note
type: folder
noteSchemas:
 default: blog-post
 hub: project-hub
classification:
 supplemental: [assets, templates]
 skip: [archive]
hub:
 detection:
 - pattern: "_{{folderName}}"
 required: true

Notizen wählen Schemas über note_schema: <name> im Frontmatter aus oder automatisch über die Konventionskaskade (_conventions.md-Dateien).

Tools

Kompatible Viewer

MarkScribe funktioniert mit jedem Tool, das Markdown-Dateien liest:

• Obsidian – PKM-App mit Graph-Ansicht und Community-Plugins

• Foam – VS Code-Erweiterung für verlinkte Notizen

• Logseq – Outliner mit bidirektionalen Links

• Jeder Texteditor oder Static Site Generator

Danksagungen

Erstellt mit Claude Code.

Lizenz

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• create_noteA
• delete_noteA
• find_bidirectional_mentionsA
• find_broken_linksA
• find_orphansA
• find_unlinked_mentionsA
• get_backlinksA
• get_frontmatterA