Claude Code 与 Obsidian MCP 连接指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_6556e935/claude-code-obsidian-mcp。
技能介绍
为什么要把 Claude Code 接进 Obsidian
如果你用 Obsidian 管理笔记,多半遇到过这种场景:想让 Claude Code 帮你复盘昨天的工作笔记、从 vault 里检索某次 API 设计草稿,或者批量整理散落的 snippet。问题不在于 Claude Code 能力不够,而在于它默认看不到你的本地笔记。这个技能解决的正是打通两者的配置问题——让已有的 Obsidian vault 通过标准 MCP 接口暴露给 Claude Code 读写。
核心思路是:在 Obsidian 侧挂一个提供 MCP 端点的插件,再把端点地址和 API Key 交给 Claude Code。关键步骤包括:
- 插件选型:推荐
Local REST API(成熟稳定、自带 MCP 端点、社区活跃),备选Semantic Notes Vault MCP(纯 MCP、支持 graph traversal 和 Dataview),不推荐 Python 版mcp-obsidian(多一层依赖) - Obsidian 端配置:启用插件后获取 API Key(hex 字符串)以及 HTTP/HTTPS 端点
- Claude Code 端接入:支持三种方式——CLI 命令(推荐)、手写
settings.json的mcpServers块、或写用户级~/.mcp.json - 作用域管理:项目级
.mcp.json> 用户级~/.mcp.json>~/.claude/settings.json,可按项目隔离配置
适用边界与注意点
需要明确的是,这是一份纯配置指引文档——技能本身不会替你执行任何命令、不会修改本机文件、也不会读取或外传你的配置与凭据。所有操作都需要你在本地终端手动完成。
几个容易踩坑的地方:MCP 服务器随 Obsidian 主程序启动,Obsidian 没开就连不上;HTTPS 端点使用自签名证书,调试期建议直接走 HTTP 端点(27123 端口);settings.json 任何一处格式错误会导致整个文件被跳过,写完务必用 JSON 解析器校验。另外,API Key 仅用于 127.0.0.1 本地通信,别提交到仓库或发到公网。
使用场景
- 使用 Obsidian 维护 API 设计草稿的开发者,需要让 Claude Code 按项目作用域读取 vault 中的笔记并生成评审意见。
- 用 Obsidian 管理研究文献和读书笔记的研究者,想通过 MCP 端点让 Claude Code 检索特定主题笔记并汇总摘要。
- 团队内部维护知识库的工程师,需要把 Obsidian vault 暴露为 MCP 服务,让 Claude Code 在多项目间切换配置并操作笔记。
- 排查 MCP 连接故障的技术运维,需要对照 Local REST API 插件的端点与密钥配置步骤,逐一验证 Obsidian 与 Claude Code 的连通性。
适合人员
- 日常使用 Obsidian 管理技术文档、希望让 Claude Code 直接读写笔记的开发者。
- 负责团队内部知识库维护、需要通过本地配置文件对 Claude Code 的 MCP 服务进行作用域管理的工程师。
- 使用 Obsidian 整理大量学习资料、希望借助 Claude Code 自动检索和指定笔记内容的研究者。
- 遇到 MCP 服务连不上或配置文件格式报错、需要依据步骤逐一排查本地日志的技术运维人员。