mcp-obsidian
连接AI助手与Obsidian知识库的MCP协议桥梁
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mcp-obsidian。 它的用途是：连接AI助手与Obsidian知识库的MCP协议桥梁 完整的 Skill 内容见：https://321skill.com/skills/mcp-obsidian/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“在我的Obsidian库中，查找所有关于‘项目管理’的笔记，并总结出三个关键点。”，它会连接到你的知识库，执行搜索并返回清晰的摘要。或者
对AI说：“基于我昨天的会议记录，创建一份周报草稿。”，它会读取相关笔记，并生成结构化的周报内容。
介绍
MCPVault是一个基于模型上下文协议（MCP）标准的AI工具，旨在解决AI助手（如Claude、ChatGPT）与本地Obsidian知识库之间安全、便捷交互的难题。它作为一个服务器运行，为AI提供对笔记库的读写访问权限，同时智能保护YAML frontmatter等关键元数据不被破坏。
使用方式非常直接，用户只需通过npm安装或使用npx运行该工具，并在支持的AI客户端（如Claude Desktop、Cursor IDE）配置文件中指定Obsidian库的路径即可。配置完成后，AI助手便能理解指令，直接对用户的笔记进行读取、搜索、创建和修改等操作。
这个工具非常适合深度依赖Obsidian构建个人或项目知识体系，并希望将AI能力无缝融入知识管理流程的用户。无论是研究者、写作者、开发者还是知识工作者，都可以通过它让AI成为强大的“第二大脑”助手，提升信息处理和内容创作效率。
使用建议是，初次配置时建议先用MCP Inspector工具测试连接，确保路径正确。虽然工具设计了安全防护，但在允许AI进行写操作前，仍建议对重要库做好备份。此外，注意它需要Node.js v18.0.0或更高版本的环境支持。
核心特点
作为基于开放MCP标准的通用桥梁，它不锁定任何单一AI供应商，能同时兼容Claude、ChatGPT、Cursor等众多当前及未来支持MCP的AI平台；在提供读写能力的同时，专门设计了防护机制，有效防止AI误操作损坏Obsidian笔记的YAML frontmatter关键结构。
注意事项
不适合仅需临时、一次性读取笔记，或不愿意在本地运行Node.js服务器及配置AI客户端的用户。
常见问题
MCPVault支持哪些AI软件？
支持所有兼容MCP协议的AI助手，包括Claude Desktop、ChatGPT Desktop、Cursor、Windsurf、IntelliJ IDEA等。
使用它安全吗？会弄乱我的笔记吗？
相对安全，它专门防止YAML frontmatter损坏，但建议对重要库进行备份后再允许AI写操作。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mcp-obsidian/raw/index.md 读取 mcp-obsidian 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mcp-obsidian/raw/index.md（查看排版版本）