用途:让 OpenCode 能读写 Obsidian 笔记库(第二大腦)。当用户说「連接 Obsidian」「設定 Obsidian vault」时載入。
先備條件:已安裝 Node.js(版本不拘,由 00-env-setup 負責);已有 Obsidian vault。
主要步驟: 一、找到 Obsidian vault:先問使用者筆記本位置,常見於 OneDrive、Google Drive 或 Documents;判斷條件是資料夾存在、內含 .obsidian 子資料夾、使用者確認為主要筆記本。Windows 可用 PowerShell 搜尋含 .obsidian 的目錄。 二、安裝 mcpvault:npm install -g @bitbonsai/mcpvault;用 where.exe mcpvault(Windows)或 which mcpvault(macOS/Linux)確認安裝位置。 三、寫入 MCP 設定:編輯 ~/.config/opencode/opencode.json,加入 mcp 區塊,type 為 local,command 為 ["npx", "@bitbonsai/mcpvault", "<VAULT_PATH>"],enabled 為 true;Windows 路徑需轉義。 四、驗證:重開 OpenCode,請它列出 vault 根目錄資料夾,再建立一則測試筆記。
附帶的三層結構設定:每日筆記/(第一層,原始輸入,每天更新)、創作庫/(第二層,加工輸出,每週更新)、知識庫/(第三層,可重複使用知識,每月更新);可在 AGENTS.md 記錄 Obsidian 路徑,並每週執行知識重整流程。
進階選項:若需全文檢索、metadata、tag 管理與筆記分析,可安裝 CLI-Anything 的 Obsidian CLI(前置需求為 Obsidian 內安裝 Local REST API 社群插件並記下 API key):pip install cli-anything-hub、cli-hub install obsidian。mcpvault 適合基本讀寫,Obsidian CLI 適合查詢與批量操作,兩者可並存。
限制與常見問題:npm install -g 若出現 EPERM,Windows 需以系統管理員身分執行;找不到 vault 可搜尋 .obsidian 資料夾;opencode.json 格式錯誤時注意 JSON 最後一項不能有逗號、路徑需用雙引號。其他功能、收費與平台資訊暫未提供。