obsidian-mcp-server：让 MCP 客户端操作 Obsidian 知识库

项目用途

obsidian-mcp-server 是一个面向 Obsidian vault 的 MCP 服务器。它通过 Obsidian 的 Local REST API 插件，让兼容 MCP 的客户端读取、搜索和修改笔记，而不是只把整个文件交给模型处理。项目支持 STDIO，也支持本地 Streamable HTTP 服务，适合希望在 AI 工作流中继续使用 Markdown 知识库的人。

它的核心价值在于“局部操作”。除了读取原始内容、结构化笔记和文档映射，工具还可以定位标题、块或 frontmatter 字段，对目标区域追加、前置、替换或删除内容。标签可以在 frontmatter、正文行内，或两者之间管理；frontmatter 则支持读取、设置和删除单个键。

已知功能

README 列出 14 个工具与 3 类资源。笔记管理包括递归列出文件、按文本或 JSONLogic 搜索，以及在条件满足时调用 Omnisearch 的 BM25 搜索。写入工具覆盖新建、整文件覆盖、指定章节修改、正则或字面量替换。项目还可以列出标签及使用次数，并通过 obsidian://vault/{+path}、obsidian://tags 和 obsidian://status 提供资源访问。

权限方面，README 说明可用文件夹范围限制读写；设置 OBSIDIAN_READ_PATHS 后，列表和标签结果会按可读范围过滤。命令面板相关工具则需要通过 OBSIDIAN_ENABLE_COMMANDS 选择性启用。删除操作不是普通的无条件写入：v3.6.1 的发布说明称，删除必须兑换服务器保存的同意记录；HTTP 启动还要求使用有状态会话，STDIO 不受此项影响。

适合谁

它适合已经使用 Obsidian 管理个人知识、项目资料或团队文档，并希望让 AI 客户端执行可控文件操作的用户。熟悉 MCP、Obsidian 插件和本地服务配置的人更容易完成接入。对于只需要问答、不希望模型修改 vault 的用户，项目的写入和命令执行能力可能超出实际需求。

采用前的限制与部署考虑

首先，项目依赖 Obsidian Local REST API 插件；README 也将 Omnisearch 搜索明确限定为“插件在启动时可访问”的情况，因此不能把 BM25 搜索视为无条件可用。其次，STDIO 与 HTTP 是不同部署路径，HTTP 的有状态会话要求需要纳入客户端和代理配置评估。

其次，写入、正则替换、执行命令和永久删除都可能改变本地知识库。虽然删除流程包含同意记录校验，但发布资料没有在这里确认完整备份、恢复策略或所有部署环境下的安全边界。采用前应先划定可读写文件夹，谨慎启用命令能力，并验证路径、frontmatter 和删除流程是否符合自己的工作习惯。

仓库元数据标注 Apache License 2.0，项目目前未归档；但许可证并不等于对具体环境的兼容性承诺。来源没有提供最低硬件要求、性能指标或完整平台兼容矩阵，这些信息仍需使用者自行确认。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-10-06