快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: uvx 运行 mcp-obsidian，使用 stdio；需要 Obsidian Local REST API 插件
安装命令:
uvx mcp-obsidian验证提示词
在我的 vault 中搜索提到 "MCP" 的笔记，并总结关键要点。
成功时应看到
应看到 vault 中匹配的笔记及简短总结。
常见陷阱与修复
- ⚠️ 注意: Vault 路径 scope、链接规范，以及避免误改文件。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- Local REST API 会在本地暴露你的 vault；保密 OBSIDIAN_API_KEY 并绑定到 127.0.0.1。
- 在启用笔记编辑前，优先使用读取与搜索类工作流。
常见错误
Vault 路径
确认 Obsidian 已打开目标 vault，Local REST API 插件已启用，并且配置指向正确的本地端口。
文件权限
如果能连接但无法读取笔记，检查 vault 文件权限、同步客户端锁定状态和 OBSIDIAN_API_KEY。
同步冲突
先使用读取和搜索能力验证，再开启写入。避免多个客户端同时修改同一笔记。
| 错误 | 原因 | 修复方法 |
|---|---|---|
Connection refused | Obsidian 或 Local REST API 插件未运行。 | 打开 Obsidian 并启用 Local REST API 插件后重试。 |
401 Unauthorized | OBSIDIAN_API_KEY 不正确。 | 从 Local REST API 插件设置里复制 key 填入 OBSIDIAN_API_KEY。 |
No results | 打开了错误的 vault，或没有匹配笔记。 | 确认 Obsidian 中打开的是目标 vault。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 在我的 vault 中搜索与"MCP"相关的笔记，并总结关键结论。
- 找出所有带 #todo 标签的笔记，按主题提取任务清单。
- 创建一篇"Weekly Review"草稿笔记，并链接到最近编辑的 5 篇笔记。
常见问题
Vault 路径应该怎么设置？
确认 Obsidian 打开了正确的 vault，且 Local REST API 插件已启用并绑定到 127.0.0.1。
文件权限不足怎么办？
Obsidian 的 Local REST API 需要 vault 文件可读。检查文件系统权限，并确保 OBSIDIAN_API_KEY 正确。
同步冲突如何避免？
优先使用读取和搜索工作流，再启用笔记编辑。避免多个客户端同时修改同一文件。