Obsidian MCP server 是给私密知识库开的一个受控入口。文件系统当然也能读 Markdown，但知识库需要更窄的边界。工具应该知道自己能进哪座 Vault、能改哪些文件、覆盖前要不要确认，以及误改后从哪里恢复。直接给整个磁盘权限很方便，长期用起来却太粗。
这套 server 不复制知识库，也不把笔记搬到云端。它只在已经配置的 Vault 内提供列出、读取、搜索、写入、追加、替换和删除接口，让 Codex 能按相对路径处理 Markdown 与常见文本文件。 list vaults 、 list notes 、 read note 和 search notes 负责只读检索， write note 默认不覆盖已有文件，只有显式设置 overwrite 才能替换。所有 note path 都必须相对 Vault 根目录，解析后还要检查，不能逃出根目录。Obsidian MCP 的受控入口示意
我把“能退”放在“能写”前面。追加、替换、覆盖写入和删除默认留下备份，删除也不该只返回一句成功。知识库不是临时文件夹，改错一次可能会污染后面的很多判断。
Codex 找到本机 Vault 配置，搭建 server、注册 MCP、补上路径检查与备份策略，并用客户端完成存、取、改的连通测试。后续知识库搭建也沿用了相对路径、先读后写和分阶段确认这些约束。我决定只开放明确配置的 Vault，并保留覆盖和删除的人工边界。公开验收只核对 server 与 README，不读取或展示真实笔记内容。
本地 MCP server 与工具接口可用。公开档案只记录结构、能力和安全约束，不发布配置文件、Vault 清单、测试笔记或任何私人内容。本地工具能降低误操作风险，仍然要配合笔记本身的事实核查、权限判断和人工复核。备份也只是补救手段，重要知识库仍应有独立备份方案。