MCPVault：一个本地 MCP 服务器

10次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 mcpvault

用 Obsidian 记笔记的人迟早会想问 AI 一个问题：能不能直接读我的笔记库，帮我找、帮我整理，而不是让我一段段复制粘贴。MCPVault 就是为这件事做的笔记接入工具：一个本地 MCP 服务器，让支持 MCP 的 AI 客户端在限定好的笔记库根目录内读取、搜索和编辑笔记，同时用路径校验挡住越界访问。本篇讲它怎么接、怎么配，以及开通写入权限前必须先做的几件事。

MCPVault 笔记接入是怎么工作的：本地进程、不碰云端

据源稿介绍，MCPVault 是用 TypeScript 编写的本地 MCP 服务器，由兼容的 MCP 客户端通过 stdio 启动，并接收配置好的 Obsidian vault 路径。它直接读写笔记库文件，不需要 Obsidian 正在运行，也不需要安装 Obsidian 插件。客户端与服务器之间走本地进程通信，耦合度相对较低，换客户端时服务器本身不用重搭。

它提供的能力覆盖笔记常见操作：读取、写入、修改、删除和移动笔记或文件，按目录和批量读取，笔记大纲与指定行读取，以及多词匹配加 BM25 重排序的笔记搜索。写入之外还有一层保护：据源稿介绍，项目会阻止路径遍历、符号链接逃逸，以及对隐藏文件、.obsidian、.git 和 node_modules 的访问；更新 frontmatter 时采用 AST 感知的方式，保留未修改 YAML 字段的原有格式，不会把整个文件头重写一遍。

软件信息表

软件名称	MCPVault
类型	本地 MCP 服务器（开源工具）
开发语言	TypeScript
许可证	MIT（仓库页面已核实）
运行环境	Node.js v22.12.0 或更高版本（据仓库说明）
接入方式	本地 stdio，由 MCP 客户端启动
平台形态	本地部署

版本选择：先用 npm 包，只读模式起步最稳

结论先行：普通用户直接用 npm 发布的包；先以只读模式跑通，再决定是否开通写入。

方式	做法	适合谁
npm 包（推荐）	通过 npm 包安装入口接入，客户端配置里写包名与笔记库路径	只想尽快用起来的大多数人
只读模式	在参数后加只读选项，仅暴露读取类工具	先验证搜索与读取效果、不想让 AI 改笔记的人
源码构建	克隆仓库后按开发方式安装依赖、启动服务	要改代码、做二次开发的人

这个排序的理由很实际：笔记库是个人核心资料，写入和删除一旦误操作很难挽回。只读模式先跑几天，确认搜索结果和读取范围都符合预期，再放开写入，顺序不要反过来。

安装步骤

先装好 Node.js 运行环境，版本要求为 v22.12.0 或更高版本，具体以仓库说明为准。
用 MCP 检查器先单独测试服务器是否能启动、能否读到笔记，确认无误再接到日常用的 AI 客户端里。
在客户端配置里加入 MCP 服务器，命令为 npx，参数为包名加实际笔记库路径，把示例里的路径换成自己的真实路径。
在客户端里先问两个验证问题，例如列出笔记库文件、读一篇已知笔记，确认连接正常后再日常使用。

装完必改设置：这四处决定安全边界

以下为按软件功能整理的配置建议，不是实测记录：

笔记库路径只给一个根目录：配置里传入的路径就是 AI 能操作的全部范围，宁可给小一点。体感差别是越界访问从配置层面就被挡住，不用事后补救。
先开只读模式：在参数后加只读选项，让服务器只暴露读取类工具。体感差别是 AI 再怎么理解偏差，也改不了、删不了你的笔记。
排除不需要被搜索的目录：用排除参数把归档、快照类子目录排除在搜索与目录读取之外。体感差别是搜索结果更干净，不会被旧笔记干扰。
开通写入前先备份笔记库：放开写入、移动、删除之前，把整个笔记库完整备份一次，并确认备份能恢复。体感差别是批量操作出问题时有回头路。

注意事项：这四条先看清再接

客户端必须支持本地 stdio：据源稿介绍，它面向支持本地 stdio MCP 服务器的客户端，普通远程 API 客户端不能直接用，选型前先确认自己的客户端在不在支持范围。
被排除的目录就是用不了：隐藏文件、.obsidian、.git 和 node_modules 会被挡住，需要访问这些目录的工作流不适用，不要指望绕过。
远程、多用户、云同步冲突不在覆盖范围：据源稿介绍，仓库说明未提及远程部署、多用户权限与云端同步冲突处理，有这些需求的要另外比较方案。
工具参数以仓库说明为准：原稿摘要未完整列出全部工具参数、错误处理和权限模型，集成前先看仓库说明或源码，不要仅凭摘要推断。