/ 目錄 / 演練場 / Obsidian Second Brain
● 社群 eugeniughelbur ⚡ 即開即用

Obsidian Second Brain

作者 eugeniughelbur · eugeniughelbur/obsidian-second-brain

讓 Claude 感知你的知識庫 — 優先以筆記進行研究、用代理維護反向連結、MOC 和定期回顧佇列。

Obsidian Second Brain 是一套 Claude Code skill,將你的 Obsidian vault 視為第一優先的研究基底。31 個指令涵蓋依模板建立筆記、vault 優先研究(先搜尋內部筆記,再去外部網路)、反向連結衛生、MOC(內容地圖)維護,以及讓 vault 保持健康的排程代理執行。為嚴肅的知識工作者設計,不是隨意記筆記的人。

為什麼要用

核心特性

即時演示

實際使用效果

就緒

安裝

選擇你的客戶端

~/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. 捕捉
    建立一個新的原子筆記,綜合這些內容。連結到所有來源筆記。加入「attention」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

排程每週回顧代理

👤 PKM 愛好者 ⏱ ~20 min beginner

何時使用: 週日早上的儀式 — 孤立筆記、過時項目、每日筆記彙整。

步驟
  1. 設定
    Obsidian-2brain:設定每週回顧。任務:列出孤立筆記、列出 90 天未開啟的筆記、生成本週的每日筆記彙整。✓ 已複製
    → 排程已註冊;第一次試跑
  2. 查看輸出
    現在執行每週回顧。給我看報告。✓ 已複製
    → 帶有具體行動項目的報告

結果: Vault 保持健康,無需你親自照看。

注意事項
  • 自動封存刪除了真實的筆記 — Skill 只建議,從不刪除;行動前先審閱

組合

與其他 MCP 搭配,撬動十倍槓桿

obsidian-second-brain-skill + filesystem

在 vault 路徑中讀寫筆記

讀取 vault/Areas/ 中的所有內容。依主題分群。✓ 已複製
obsidian-second-brain-skill + personal-os-skills

將 vault 優先研究與更廣泛的 Obsidian skill 套件結合

執行每週回顧(2brain)。然後執行本週的 capture-rollup(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 (none) 每週回顧 0
review_queue (none) 間隔回顧 0
schedule_agent cadence, tasks[] 設定自動化 0

成本與限制

運行它的成本

API 配額
N/A
每次呼叫 Token 數
Vault 搜尋保持精簡;全 vault 分群可達 5k–30k
費用
免費
提示
積極使用 vault_search — 它是帶入大量 context 前的快速過濾器

安全

權限、密鑰、影響範圍

最小權限: filesystem-read filesystem-write
憑證儲存:
資料出站: 無 — vault 保持本機

故障排查

常見錯誤與修復

vault_search 雖然有明顯的比對但回傳空

Vault 路徑可能錯誤;在 Skill 設定中驗證

MOC 與現有樞紐重疊

先偵測現有的;合併而非重複建立

排程代理不執行

Skills 在 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