MarkScribe

用于 Model Context Protocol 的具备规范意识的 Markdown MCP 服务器。MarkScribe 让 AI 代理能够读取、写入、搜索和验证 Markdown 文件，并通过用户定义的 YAML 模式强制执行规范。适用于任何 Markdown 目录：Obsidian 库、Foam 工作区、数字花园、文档仓库等。

功能特性

• 通过原子文件操作读取、写入、移动和删除笔记

• 跨内容和元数据的全文搜索（BM25 排名）

• 支持维基链接（Wikilink）：反向链接、断链检测、孤立文件查找、未链接提及发现

• 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 — 带有图谱视图和社区插件的 PKM 应用

• 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