MarkScribe

MCP-сервер для Model Context Protocol, поддерживающий соглашения при работе с Markdown. MarkScribe позволяет ИИ-агентам читать, записывать, искать и проверять файлы Markdown, обеспечивая соблюдение соглашений с помощью пользовательских YAML-схем. Работает с любыми директориями Markdown: хранилищами Obsidian, рабочими пространствами Foam, «цифровыми садами» и репозиториями документации.

Возможности

• Чтение, запись, перемещение и удаление заметок с помощью атомарных файловых операций

• Полнотекстовый поиск (ранжирование BM25) по содержимому и метаданным (frontmatter)

• Поддержка вики-ссылок: обратные ссылки, обнаружение битых ссылок, поиск «сиротских» заметок, обнаружение не связанных упоминаний

• Парсинг, проверка и массовое обновление YAML-метаданных

• Управление тегами (в метаданных и внутри текста)

• Обеспечение соблюдения соглашений с помощью схем — схемы заметок проверяют метаданные/содержимое, схемы папок обеспечивают соблюдение структурных правил

• Каскад соглашений: файлы _conventions.md определяют область действия схем для поддеревьев директорий

• Безопасность путей: .obsidian/, .git/, node_modules/ всегда заблокированы

Related MCP server: mcp-obsidian

Установка

npm install -g markscribe

Использование

Как MCP-сервер

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

Флаги CLI

Конфигурация для каждой директории

Разместите файл .markscribe/config.yaml в корневой директории:

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

Схемы

Схемы определяют соглашения для ваших заметок и папок. Разместите их в директории схем (по умолчанию ~/.markscribe/schemas/).

Схема заметки — проверяет поля метаданных и правила содержимого:

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

Схема папки — обеспечивает соблюдение структурных правил для директорий:

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

Заметки подключаются к схемам через note_schema: <name> в метаданных или автоматически через каскад соглашений (файлы _conventions.md).

Инструменты

Совместимые просмотрщики

MarkScribe работает с любым инструментом, который читает файлы Markdown:

• Obsidian — приложение для управления личными знаниями с графовым представлением и плагинами сообщества

• Foam — расширение для VS Code для связанных заметок

• Logseq — аутлайнер с двунаправленными ссылками

• Любой текстовый редактор или генератор статических сайтов

Благодарности

Создано с помощью Claude Code.

Лицензия

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