Semantic Notes Vault MCP

社区

在 Obsidian 内运行的 MCP 服务器，让 AI 助手直接读写和遍历你的知识库。

分类: 文件系统第 11 / 24
Stars: ★ 466 非常热门
传输方式: Streamable HTTP
运行环境: 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 36 天前
工具数: 8

59FMRS · C

该服务器将 MCP 服务直接内置于 Obsidian 插件中，通过 HTTP/HTTPS 提供细粒度权限控制的仓库访问、编辑与知识图谱遍历能力，适合已使用 Obsidian 且需要 AI 深度理解笔记关联的用户，但作为第三方插件需要用户自行管理密钥、证书与操作权限范围。

最强项 · 文档质量 15/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

11/20

维护活跃度

13/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 7/20: README 声称提供 8 个工具、共计约 20+ 个子操作（如 vault 工具含 13 种操作），但未提供服务器清单缓存、测试文件或 CI 工作流等可验证证据，无法确认 MCP 初始化/工具列表握手与声明行为是否一致。根据静态校准规则，缺乏可执行证据时可靠性不得超过 12 分；此处仅有 README 描述而无源码或测试可查，进一步扣分至较低区间。
安全与权限 11/20: 存在积极信号：支持只读模式、按操作权限控制、路径允许/阻止列表、API 密钥认证，并明确警告不要使用 NODE_TLS_REJECT_UNAUTHORIZED=0（说明作者具备安全意识）。但也有明显缺口：HTTP 明文端口（3001）默认可用，密钥以 Bearer token 形式传输，未说明服务器是否仅绑定 localhost；system 工具含'web fetch'即外部网络访问能力，且 edit/vault 工具可执行移动、删除、拆分合并等不可逆操作，README 中未描述任何危险操作的二次确认机制。未达到红线级别，但权限最小化与确认机制均不完整。
维护活跃度 13/20: 项目未归档，MIT 许可证明确，455 星、13 个未关闭 issue，并已上架 Obsidian 官方社区插件目录（说明经过一定审核）。但 README 未展示发布节奏、提交历史、依赖更新策略或专门的安全响应渠道，这些信息均无法从提供材料中验证，只能视为维护活跃但治理细节不明。
文档质量 15/20: 文档结构分层清晰：快速开始、三种客户端接入路径、自签名证书信任的平台差异说明、以及指向 vault/edit/graph/dataview/security/configuration/troubleshooting 等专题文档的链接，覆盖面广。但具体工具参数、调用限制、成本说明均在外部链接文档中，本次评审未能读取这些文件核实其真实内容是否与承诺一致，存在'文档存在但未经核验'的不确定性。
安装易用性 13/20: 提供三条清晰路径（.mcpb 一键拖拽安装、Claude Code 命令行一条命令、通用 JSON 配置），并详细说明了 HTTPS 自签名证书信任的平台差异（特别是 Bun 不读取 macOS 钥匙串这一非常规坑点）。步骤具体但仍属人工操作，涉及证书信任、环境变量传播等易出错环节，且无可执行证据验证真实可行性，根据静态校准规则设置分不得超过 15。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

已经在使用 Obsidian 管理个人或团队知识库的用户
希望 AI 助手能理解笔记间链接结构而非单篇孤立文件的场景
使用 Claude Desktop、Claude Code 或其他本地 MCP 客户端的用户

不适合谁

不使用 Obsidian 的用户
需要云端托管、无需本地运行服务的 MCP 方案
需要官方 Obsidian 团队维护和支持保障的场景（本插件为第三方开发）

所需权限

API 密钥认证（Bearer Token）访问 HTTP/HTTPS 本地服务端口
对 Obsidian 仓库的文件读写、创建、移动、拆分合并权限
可配置为只读模式、按操作细粒度授权，以及路径允许/阻止列表

风险与副作用

默认（非只读）配置下 AI 可修改、移动或合并仓库中的笔记文件，操作不当可能造成内容丢失或结构混乱
HTTPS 使用自签名证书，需妥善保管证书文件，避免用 NODE_TLS_REJECT_UNAUTHORIZED=0 等方式全局关闭证书校验
为第三方社区插件（非 Obsidian 官方维护），更新和长期支持取决于维护者

安装接入

准备工作

运行环境：预编译二进制

其他可选配置项（1 个）

NODE_EXTRA_CA_CERTS 可选指向插件自签名证书（vault 内 .obsidian/plugins/semantic-vault-mcp/certificates/default.crt）的路径，Bun 运行时（如 Claude Code）经 HTTPS 连接时必需。

1) 在 Obsidian 的 Settings → Community plugins 中搜索并安装 "Semantic Notes Vault MCP"（或通过 BRAT 安装测试版）。2) 在插件设置页生成 API 密钥和服务地址。对 Claude Desktop，从插件设置页或 GitHub Releases 下载 .mcpb 包，拖入 Claude Desktop 窗口并粘贴密钥即可；对 Claude Code，运行插件设置页提供的 claude mcp add --transport http 命令；对 Cline/Continue 等其他客户端，将给出的 JSON 配置（含 URL 和 Bearer 密钥）添加到客户端的 MCP 配置文件中。3) 如使用 HTTPS，需要手动信任插件自动生成的自签名证书（macOS 钥匙串或设置 NODE_EXTRA_CA_CERTS，Bun 运行时如 Claude Code 必须使用后者）。

claude_desktop_config.json

{"mcpServers":{"obsidian-vault":{"transport":{"type":"http","url":"http://localhost:3001/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "obsidian-vault": {
      "transport": {
        "type": "http",
        "url": "http://localhost:3001/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 vault、edit、view、graph、workflow、dataview、bases、system 这 8 个工具；也可直接问“我的 vault 里有哪些笔记？”来验证连接。

常见排障

确认 Obsidian 插件已启用，且 HTTP(3001)/HTTPS(3443) 端口未被占用或防火墙拦截
确认客户端配置中的 API 密钥与插件设置页显示的一致
Claude Code 等基于 Bun 的客户端连接 HTTPS 失败时，需设置 NODE_EXTRA_CA_CERTS 指向插件证书，而非依赖系统钥匙串
证书到期（有效期 1 年）后需重新信任新生成的证书

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 vault 根目录下的所有笔记
在笔记中搜索包含 tag:psychology 的内容
找出我的心理学笔记和哲学笔记之间的关联
总结我这周的会议笔记

工具能力 8

vault 写入

文件操作：列出、读取、创建、搜索、移动、拆分、合并笔记等 13 种具体操作。

edit 写入

内容修改：基于窗口的编辑、追加内容、按章节打补丁。

view 只读

内容展示：查看文件、编辑窗口或当前激活的笔记。

graph 只读

链接导航：遍历知识图谱、查找路径、分析笔记间的关联。

workflow 只读

情境提示：根据当前状态建议下一步可执行的操作。

dataview 只读

查询笔记：执行 DQL（Dataview 查询语言），需安装 Dataview 插件。

bases 只读

数据库视图：查询和导出 Obsidian Bases（如已启用）。

system 只读

仓库信息：服务器状态、可用命令、网页内容抓取。

使用场景

让 AI 助手总结、搜索或综合仓库中多篇笔记的内容

通过图谱遍历发现不同主题笔记之间的隐藏关联

让 AI 直接创建、编辑或重组笔记（拆分、合并、移动）

结合 Dataview 或 Bases 对结构化笔记数据做查询与分析

支持客户端

Claude Desktop

Claude Code

Cline部分支持

Continue部分支持

依据项目文档列出，未经本站实测。

详细介绍

Semantic Notes Vault MCP 是一个作为 Obsidian 插件运行的高性能 Model Context Protocol 服务器，通过 HTTP/HTTPS 传输向任何兼容 MCP 的 AI 客户端暴露对 Obsidian 仓库（vault）的直接访问。服务器本身就是插件，无需额外启动 Node 进程或桥接 REST-API 插件。它提供 8 个工具族（共约数十个具体操作），支持文件的列出、读取、创建、搜索、移动、拆分与合并，支持基于窗口的内容编辑，支持沿链接、标签和反向链接进行知识图谱遍历，并可选集成 Dataview 查询与 Obsidian Bases 数据库视图。所有操作都受用户设置的权限控制，包括只读模式、按操作粒度的控制，以及路径允许/阻止列表。