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: kmd

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