适合谁
- 已经在使用 Obsidian 管理个人或团队知识库的用户
- 希望 AI 助手能理解笔记间链接结构而非单篇孤立文件的场景
- 使用 Claude Desktop、Claude Code 或其他本地 MCP 客户端的用户
S
59FMRS · C
该服务器将 MCP 服务直接内置于 Obsidian 插件中，通过 HTTP/HTTPS 提供细粒度权限控制的仓库访问、编辑与知识图谱遍历能力，适合已使用 Obsidian 且需要 AI 深度理解笔记关联的用户，但作为第三方插件需要用户自行管理密钥、证书与操作权限范围。
Semantic Notes Vault MCP 是一个作为 Obsidian 插件运行的高性能 Model Context Protocol 服务器，通过 HTTP/HTTPS 传输向任何兼容 MCP 的 AI 客户端暴露对 Obsidian 仓库（vault）的直接访问。服务器本身就是插件，无需额外启动 Node 进程或桥接 REST-API 插件。它提供 8 个工具族（共约数十个具体操作），支持文件的列出、读取、创建、搜索、移动、拆分与合并，支持基于窗口的内容编辑，支持沿链接、标签和反向链接进行知识图谱遍历，并可选集成 Dataview 查询与 Obsidian Bases 数据库视图。所有操作都受用户设置的权限控制，包括只读模式、按操作粒度的控制，以及路径允许/阻止列表。
工具能力
vault
文件操作：列出、读取、创建、搜索、移动、拆分、合并笔记等 13 种具体操作。
edit
内容修改：基于窗口的编辑、追加内容、按章节打补丁。
view
内容展示：查看文件、编辑窗口或当前激活的笔记。
graph
链接导航：遍历知识图谱、查找路径、分析笔记间的关联。
workflow
情境提示：根据当前状态建议下一步可执行的操作。
dataview
查询笔记：执行 DQL（Dataview 查询语言），需安装 Dataview 插件。
bases
数据库视图：查询和导出 Obsidian Bases（如已启用）。
system
仓库信息：服务器状态、可用命令、网页内容抓取。
安装接入
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"}}}}}
选型与风险
不适合谁
- 不使用 Obsidian 的用户
- 需要云端托管、无需本地运行服务的 MCP 方案
- 需要官方 Obsidian 团队维护和支持保障的场景（本插件为第三方开发）
所需权限
- API 密钥认证（Bearer Token）访问 HTTP/HTTPS 本地服务端口
- 对 Obsidian 仓库的文件读写、创建、移动、拆分合并权限
- 可配置为只读模式、按操作细粒度授权，以及路径允许/阻止列表
风险与副作用
- 默认（非只读）配置下 AI 可修改、移动或合并仓库中的笔记文件，操作不当可能造成内容丢失或结构混乱
- HTTPS 使用自签名证书，需妥善保管证书文件，避免用 NODE_TLS_REJECT_UNAUTHORIZED=0 等方式全局关闭证书校验
- 为第三方社区插件（非 Obsidian 官方维护），更新和长期支持取决于维护者
常见排障
- 确认 Obsidian 插件已启用，且 HTTP(3001)/HTTPS(3443) 端口未被占用或防火墙拦截
- 确认客户端配置中的 API 密钥与插件设置页显示的一致
- Claude Code 等基于 Bun 的客户端连接 HTTPS 失败时，需设置 NODE_EXTRA_CA_CERTS 指向插件证书，而非依赖系统钥匙串
- 证书到期（有效期 1 年）后需重新信任新生成的证书
使用场景
让 AI 助手总结、搜索或综合仓库中多篇笔记的内容
通过图谱遍历发现不同主题笔记之间的隐藏关联
让 AI 直接创建、编辑或重组笔记（拆分、合并、移动）
结合 Dataview 或 Bases 对结构化笔记数据做查询与分析
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cline部分支持
Continue.dev部分支持