F
license-
qualityF
maintenanceAn MCP server for managing LifeOS Obsidian vaults, enabling AI assistants to create, read, and search notes with YAML compliance and organizational standards.
1
MarkScribe
by Erodenn
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: kmd
安装
npm install -g markscribe使用方法
作为 MCP 服务器
{
"mcpServers": {
"markscribe": {
"command": "markscribe",
"args": ["--root", "/path/to/your/notes"]
}
}
}CLI 标志
标志 | 默认值 | 描述 |
| 当前工作目录 | 要服务的根目录 |
|
| 加载模式 YAML 文件的目录 |
|
| 日志级别 ( |
目录级配置
在根目录中放置一个 .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 文件）自动加入。
工具
工具 | 描述 |
| 列出文件和子目录 |
| 笔记计数、总大小、最近文件 |
| 更改活动根目录 |
| 读取带有已解析元数据的笔记 |
| 创建或更新笔记 |
| 笔记内的字符串替换 |
| 删除笔记（需确认） |
| 移动/重命名（可选链接更新） |
| 批量读取最多 10 个笔记 |
| 具备规范意识的笔记创建 |
| 仅读取 YAML 元数据 |
| 合并或替换元数据字段 |
| 添加、删除或列出标签 |
| 全文 BM25 搜索 |
| 根据其模式验证笔记 |
| 分类并验证文件夹 |
| 递归子树验证 |
| 完整目录树验证 |
| 列出所有已加载的模式 |
| 查找链接到某笔记的笔记 |
| 查找指向不存在笔记的维基链接 |
| 查找没有入站链接的笔记 |
| 查找应为维基链接的纯文本提及 |
兼容的查看器
MarkScribe 适用于任何读取 Markdown 文件的工具：
致谢
使用 Claude Code 构建。
许可证
MIT
Maintenance
–Maintainers
–Response time
0dRelease cycle
6Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityBmaintenanceMCP server for structured markdown knowledge vaults that provides validation, FTS5 search, and wikilink cross-references. Enables AI agents to prime context and search across vaults using two MCP tools and template resources.6MIT
- Alicense-qualityBmaintenancePython MCP server for programmatic access to markdown-based knowledge vaults, enabling AI assistants to browse, read, search, update, and manage notes, tasks, and projects.1MIT
- FlicenseAqualityAmaintenanceA filesystem-based MCP server for Obsidian vaults that enables LLMs to browse, search, read, write, and edit Markdown notes directly on disk without requiring Obsidian to be running.61,8711
Related MCP Connectors
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
MCP server for AgentDocs (agentdocs.eu): read, search, write, comment on & share Markdown docs.
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Erodenn/markscribe'
If you have feedback or need assistance with the MCP directory API, please join our Discord server