MarkScribe

Servidor MCP de markdown consciente de las convenciones para el Model Context Protocol. MarkScribe permite a los agentes de IA leer, escribir, buscar y validar archivos markdown, aplicando convenciones a través de esquemas YAML definidos por el usuario. Funciona con cualquier directorio de markdown: bóvedas de Obsidian, espacios de trabajo de Foam, jardines digitales, repositorios de documentación.

Características

• Leer, escribir, mover y eliminar notas con operaciones de archivo atómicas

• Búsqueda de texto completo (ranking BM25) en contenido y frontmatter

• Consciente de wikilinks: backlinks, detección de enlaces rotos, búsqueda de huérfanos, descubrimiento de menciones sin enlazar

• Análisis, validación y actualizaciones masivas de frontmatter YAML

• Gestión de etiquetas (frontmatter e inline)

• Aplicación de convenciones mediante esquemas: los esquemas de notas validan el frontmatter/contenido, los esquemas de carpetas aplican reglas estructurales

• Cascada de convenciones: los archivos _conventions.md limitan los esquemas a subárboles de directorios

• Seguridad de rutas: .obsidian/, .git/, node_modules/ siempre bloqueados

Related MCP server: mcp-obsidian

Instalación

npm install -g markscribe

Uso

Como servidor MCP

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

Flags de la CLI

Configuración por directorio

Coloque un .markscribe/config.yaml en su directorio raíz:

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

Esquemas

Los esquemas definen convenciones para sus notas y carpetas. Colóquelos en su directorio de esquemas (por defecto ~/.markscribe/schemas/).

Esquema de nota — valida campos de frontmatter y reglas de contenido:

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: "\\[\\[.+?\\]\\]"

Esquema de carpeta — aplica reglas estructurales en directorios:

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

Las notas se integran en los esquemas mediante note_schema: <name> en el frontmatter, o automáticamente mediante la cascada de convenciones (archivos _conventions.md).

Herramientas

Visores compatibles

MarkScribe funciona con cualquier herramienta que lea archivos markdown:

• Obsidian — Aplicación PKM con vista de gráfico y plugins de la comunidad

• Foam — Extensión de VS Code para notas enlazadas

• Logseq — Outliner con enlaces bidireccionales

• Cualquier editor de texto o generador de sitios estáticos

Agradecimientos

Construido con Claude Code.

Licencia

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