/ 目录 / 演练场 / Obsidian Second Brain
● 社区 eugeniughelbur ⚡ 即开即用

Obsidian Second Brain

作者 eugeniughelbur · eugeniughelbur/obsidian-second-brain

让 Claude 感知你的 vault——优先从笔记中研究,调度 agent 维护反向链接、MOC 和定期回顾队列。

Obsidian Second Brain 是一套 Claude Code skill,将你的 Obsidian vault 作为第一性研究基底。31 条指令覆盖按模板创建笔记、vault 优先研究(先搜内部笔记再打开网络/AI)、反向链接卫生、MOC(内容地图)维护,以及保持 vault 健康的定时 agent 运行。面向严肃的知识工作者,不是休闲记录者。

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-second-brain-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-second-brain-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/eugeniughelbur/obsidian-second-brain",
          "~/.claude/skills/obsidian-second-brain"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add obsidian-second-brain-skill -- git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/.claude/skills/obsidian-second-brain

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: Obsidian Second Brain

vault 优先、网络其次地研究一个话题

👤 研究人员、写作者、知识工作者 ⏱ ~45 min intermediate

何时使用: 你在研究一个自己以前思考过的话题,想先把自己之前的思路挖出来。

前置条件
  • 已安装 skill — git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/.claude/skills/obsidian-second-brain
  • vault 路径 — 在 skill 配置中设置:指向 .obsidian vault 路径
步骤
  1. 内部优先
    Obsidian-2brain:研究「专注 vs 意图」,第一遍:搜索我的 vault,列出相关笔记,附日期和关键观点。✓ 已复制
    → 具体的笔记列表,附引用观点——不是「没找到相关笔记」
  2. 综合我的思考
    综合分析:基于这些笔记,我的观点是如何演变的?指出随时间出现的矛盾之处。✓ 已复制
    → 对你思维的诚实总结,矛盾点有明确指出
  3. 外部补充
    第二遍:我的观点有哪些不足?现在引入外部资料来填补空缺。✓ 已复制
    → 有针对性的外部研究,补充而非替代内部思考
  4. 捕获
    创建一条新的原子笔记,综合本次研究,链接所有来源笔记,添加到「专注」MOC。✓ 已复制
    → 笔记已创建在 inbox,带正确的反向链接

结果: 基于自己既有思考的研究,而不是每次从零开始。

注意事项
  • vault 混乱 → 内部搜索毫无价值 — 先跑一遍反向链接卫生整理;不要在乱糟糟的 vault 上做研究
搭配使用: filesystem

为某个话题群构建内容地图(MOC)

👤 vault 维护者 ⏱ ~30 min intermediate

何时使用: 你在某个话题上有 50+ 条笔记,但它们处于无序状态。

步骤
  1. 聚类
    Obsidian-2brain:对所有标有 #productivity 的笔记进行聚类,提出 3–5 个子主题。✓ 已复制
    → 清晰的聚类提案
  2. 构建 MOC
    创建「Productivity MOC.md」,按聚类分节,链接相关笔记,每个聚类附简要框架说明。✓ 已复制
    → 枢纽页已创建;反向链接已建立

结果: 这个话题现在可以从单个枢纽页导航。

注意事项
  • MOC 变成垃圾堆 — 限制在 30 条链接以内;其余放入子 MOC

配置每周回顾 agent

👤 PKM 爱好者 ⏱ ~20 min beginner

何时使用: 周日早上例行——孤立笔记、过时条目、每日笔记汇总。

步骤
  1. 配置
    Obsidian-2brain:配置每周回顾,任务包括:列出孤立笔记、列出 90 天未打开的笔记、生成本周每日笔记的汇总。✓ 已复制
    → 任务计划已注册;首次运行 dry-run
  2. 查看报告
    现在执行每周回顾,展示报告。✓ 已复制
    → 包含具体行动项的报告

结果: vault 保持健康,无需你时刻盯着。

注意事项
  • 自动归档删除了真实笔记 — skill 只建议,不删除;执行前先审阅

组合

与其他 MCP 搭配,撬动十倍杠杆

obsidian-second-brain-skill + filesystem

读写 vault 路径下的笔记

读取 vault/Areas/ 下的所有内容,按话题聚类。✓ 已复制
obsidian-second-brain-skill + personal-os-skills

将 vault 优先研究与更广泛的 Obsidian skill 套件结合

运行每周回顾(2brain),然后运行本周的捕获汇总(personal-os)。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
vault_search query, max_results? 在查询网络之前始终先调用 0
create_note template, title, body, links[] 捕获新原子笔记 0
build_moc topic, source_notes 为某话题构建枢纽页 0
backlink_hygiene scope? 定期维护 0
orphan_notes (无) 每周回顾 0
review_queue (无) 间隔复习会话 0
schedule_agent cadence, tasks[] 设置自动化任务 0

成本与限制

运行它的成本

API 配额
不适用
每次调用 Token 数
vault 搜索很轻量;全 vault 聚类可达 5k–30k
费用
免费
提示
多用 vault_search 做快速过滤,再带着精简结果进行深入分析

安全

权限、密钥、影响范围

最小权限: filesystem-read filesystem-write
凭据存储:
数据出站: 无——vault 保持本地

故障排查

常见错误与修复

vault_search 明明有相关笔记却返回空

vault 路径可能配置错误;在 skill 配置中核实

MOC 与已有枢纽页重叠

先检测已有页面;合并而非重复创建

定时 agent 没有运行

Skill 由 Claude 调用时运行;这里的「定时」是指记录好的例行任务,不是系统 cron

替代方案

Obsidian Second Brain 对比其他方案

替代方案何时用它替代权衡
personal-os-skills(ArtemXTech)你想要更广泛的 Claude × Obsidian 实验室不同侧重;对 vault 优先研究的强调较少
Obsidian Smart Connections 插件你想在 Obsidian 内部有 IDE 风格的建议基于插件;不是 Claude Code
Roam Research / Logseq你用的是其他 PKM 工具不同工具;skill 专为 Obsidian 设计

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills