mcpvault
连接AI助手与Obsidian知识库的通用桥梁
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:mcpvault。 它的用途是:连接AI助手与Obsidian知识库的通用桥梁 完整的 Skill 内容见:https://321skill.com/skills/mcpvault/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请在我的Obsidian库中查找所有关于‘机器学习’的笔记,并总结出三个主要的研究方向。’ 它会通过MCPVault访问你的知识库,列出相关文件,读取内容,并生成一份清晰的摘要。或者,你可以说:‘基于我昨天的会议记录‘project-meeting.md’,起草一份项目下周的待办清单。’ AI会读取指定笔记,并创建一份新的任务列表笔记。
介绍
MCPVault 解决了AI助手与本地知识库(特别是Obsidian)之间难以安全、高效交互的痛点。它基于Model Context Protocol (MCP)标准,为AI提供了一个标准化的接口来读取和写入你的笔记,同时能有效防止笔记元数据(如YAML frontmatter)被意外破坏,保障了知识库的完整性。
使用方式非常简单,只需安装Node.js环境,通过一行npx命令即可启动服务,然后在Claude Desktop、ChatGPT Desktop、Cursor IDE等支持MCP的AI客户端中进行配置,指定你的Obsidian库路径。配置完成后,AI助手就能像访问一个工具库一样,自然地查询、创建和修改你的笔记。
它非常适合深度使用Obsidian构建个人知识体系,并希望将AI作为强大助手的用户,比如研究者、写作者、程序员和知识管理者。他们可以将AI的推理、总结和创作能力直接作用于自己长期积累的、结构化的知识资产上。
与一些仅支持单向读取或特定AI平台(如仅限Claude)的工具不同,MCPVault的核心优势在于其‘通用性’。它严格遵循MCP开放协议,这意味着它不仅兼容当前主流的AI助手,也能无缝接入未来任何采纳该标准的AI平台,避免了被单一生态锁定的风险。
核心特点
严格遵循MCP开放协议,实现了真正的跨平台通用性,兼容Claude、ChatGPT、Cursor等当前及未来所有支持MCP的AI工具,而非绑定单一生态;同时具备智能的YAML frontmatter保护机制,防止AI在编辑笔记时破坏关键元数据。
注意事项
需要用户具备基础的命令行操作能力来安装和配置,且AI助手本身必须支持MCP协议才能使用。
常见问题
MCPVault支持哪些AI软件?
支持所有兼容MCP协议的AI助手,包括Claude Desktop、ChatGPT Desktop(企业版+)、Cursor IDE、Windsurf IDE、IntelliJ IDEA 2025.1+等。
使用MCPVault安全吗?会弄乱我的笔记吗?
相对安全。它提供了可控的读写权限,并专门设计了防护机制来避免AI修改时破坏笔记的YAML frontmatter等关键结构。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/mcpvault/raw/index.md 读取 mcpvault 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/mcpvault/raw/index.md(查看排版版本)