Obsidian MCP Server
基于MCP协议,让AI助手直接读写和查询你的Obsidian笔记库。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Obsidian MCP Server。 它的用途是:基于MCP协议,让AI助手直接读写和查询你的Obsidian笔记库。 完整的 Skill 内容见:https://321skill.com/skills/obsidian-mcp-server/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查一下上个月关于‘MCP协议’的会议纪要,并总结核心要点。”,它会直接在你的Obsidian库中搜索相关笔记,并返回精准的摘要。或者
对AI说:“将我们刚才讨论的项目计划整理成一份Markdown笔记,保存到我的‘Projects’文件夹。”,它会自动创建格式清晰的笔记文件。
介绍
Obsidian MCP Server是一个基于Model Context Protocol(MCP)协议开发的工具,它解决了AI助手与本地知识库(特别是Obsidian笔记库)之间无法直接交互的问题。通过它,AI可以读取、搜索、创建和修改你的Obsidian笔记,将你的个人知识库变成AI的“长期记忆”和“参考资料库”。
使用时,你需要先安装并运行这个MCP服务器,然后在支持MCP协议的AI客户端(如Claude Desktop)中配置并连接到它。配置成功后,AI助手便获得了访问你指定Obsidian库的权限,你可以在对话中直接要求AI查阅你的笔记、总结内容或基于笔记内容进行创作。
这个工具非常适合那些深度使用Obsidian构建个人知识体系,并希望AI能基于其已有知识进行工作的用户。无论是内容创作者、学术研究者,还是需要频繁整理和调用知识的开发者和学生,都能从中受益。
需要注意的是,由于它直接操作你的笔记文件,在使用前请确保对重要笔记进行备份。同时,建议在初期明确设定AI可访问的库范围,并在使用中注意指令的清晰性,以避免对笔记结构造成意外的修改。
核心特点
与需要手动复制粘贴笔记内容给AI的通用方式不同,它通过标准化的MCP协议实现了AI对Obsidian库的原生、结构化访问;与一些仅支持搜索的笔记插件相比,它提供了完整的读写和内容管理能力,并能与任何支持MCP的AI客户端无缝集成。
注意事项
不适合不熟悉命令行配置或MCP协议概念的新手用户,且其功能完全依赖于Obsidian的本地文件系统,无法直接用于云同步的笔记库(如Obsidian Sync)。
常见问题
这个工具安全吗?会泄露我的笔记吗?
完全本地运行,你的笔记数据不会上传到外部服务器,所有操作都在你的设备上完成,安全性高。
除了Claude,还能用在其他AI上吗?
可以,任何支持MCP协议的AI客户端(如Cursor、Windsurf)都能连接使用。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/obsidian-mcp-server/raw/index.md 读取 Obsidian MCP Server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/obsidian-mcp-server/raw/index.md(查看排版版本)