Graph Context for Claude Code

一款很新的 Obsidian 插件，将仓库接入 Claude Code 的 /ide 选择器：选中文本时会自动附带图谱上下文（已解析的链接、反向链接、标题路径）。

这是一款非常新的插件（2026 年 6 月），它让 Obsidian 出现在 Claude Code 内置的 IDE 识别机制中——采用与官方 VS Code、JetBrains 扩展相同的「锁文件 + 本地 WebSocket」方式。加载时，插件会在 127.0.0.1 上启动一个 WebSocket 服务器，并把包含端口、仓库路径和会话认证令牌的锁文件写入 ~/.config/claude/ide/<port>.lock 或 ~/.claude/ide/<port>.lock。Claude Code 会自动找到这个文件，建立连接，用令牌完成认证，随后通过 JSON-RPC 进行 MCP 通信。真正的价值在于「Graph Context」这一层：当你在笔记中选中一段文本时，插件不只是发送带有晦涩 [[链接]] 的原始 Markdown，而是在服务端用 Obsidian 自身的 metadataCache 解析器把这些链接解析出来，并把所有内容打包进同一个 payload——完整的嵌入内容 ![[Embeds]]、以摘要形式呈现的 [[Wikilinks]]（frontmatter + 首段）、光标所在的标题路径、frontmatter 以及反向链接。这与传统 Obsidian MCP 服务器的区别在于：后者需要 Claude 逐个通过工具调用解析每条链接（N 条链接 = N×2 次往返），而这里已解析好的上下文会随选区一起自动送达，无需额外的工具调用。这种解析有意只展开一层（已链接笔记内部的链接不会进一步展开），并有大小限制（嵌入内容 2000 字符、wikilink 摘要 200 字符、总计 8000 字符、反向链接 20 条），并会明确标注截断标记，而非静默截断。由于需要一个 Node WebSocket 服务器，该插件仅支持桌面版 Obsidian。

🔧 SETUP

前提是桌面版 Obsidian（插件为 isDesktopOnly），以及终端中一个可正常工作的 Claude Code 安装。
由于尚未出现在社区插件列表中，需要手动构建：克隆仓库，然后执行 `npm install && npm run build`。
把 `main.js` 和 `manifest.json` 复制到自己的仓库：`<vault>/.obsidian/plugins/graph-context-for-claude-code/`。
在 Obsidian 的 Settings → Community plugins 中关闭 Restricted Mode（如需要），并启用「Graph Context for Claude Code」——会出现提示「ready on port <PORT>」。
在另一个终端中启动 `claude`，输入 `/ide` 并选择「Obsidian」；然后在笔记中选中文本，直接向 Claude 提问。

✅ 什么时候用？

把带有大量链接的笔记作为提问上下文

选中一段链接到多篇其他笔记的段落，并提问「总结我选中的内容，以及它与所链接笔记的关系」时，Claude 在第一个 payload 中就已经拿到了链接内容，无需逐个加载。

无需 API 密钥配置即可快速查询单条笔记

如果只是在 Claude Code 编程会话中偶尔需要访问某条 Obsidian 笔记，就不必用到 Local REST API 方案那套独立的 HTTPS 服务器和 API 密钥——这里只需 `/ide` 并选择 Obsidian 即可。

⛔ 什么时候不该用？

移动端使用或未打开 Obsidian 应用时的自动化

该插件明确标记为 isDesktopOnly，需要一个正在运行、WebSocket 服务器处于活跃状态的桌面版 Obsidian 实例——不存在无头（headless）模式。

更好的选择: 如需在未打开 Obsidian 应用的情况下实现自动化，应使用带有独立 HTTPS 服务器的 Obsidian Local REST API。

需要自动携带多跳深层链接

图谱展开有意限制在一层深度——已展开的关联笔记内部的链接不会被进一步解析。

更好的选择: 如需更深层的图谱遍历，应有针对性地使用 Local REST API 的 MCP 工具，或采用像 Graphify 这样支持 Obsidian 导出的专用图谱工具。