/ 目錄 / 演練場 / Claude × Obsidian
● 社群 AgriciDaniel ⚡ 即開即用

Claude × Obsidian

作者 AgriciDaniel · AgriciDaniel/claude-obsidian

將你的 Obsidian 知識庫轉化為自我維護的 Wiki——Claude 儲存重要內容、建立連結,讓知識圖譜不斷成長,而非讓筆記沉入虛空。

以 Claude Code skill 的形式實作 Andrej Karpathy 的「LLM Wiki」模式。三個指令:/wiki 對你的知識庫提問(自動連結到現有筆記)、/save 將對話片段儲存為帶有交叉連結的結構化筆記,以及 /autoresearch 深入研究某個主題並新增一個完整有引用來源的 Wiki 條目。設計目的是讓知識庫不斷累積深度,而非只是堆積。

為什麼要用

核心特性

即時演示

實際使用效果

就緒

安裝

選擇你的客戶端

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

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

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

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

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

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

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

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

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

Continue 使用伺服器物件陣列,而非映射。

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

加入 context_servers。Zed 儲存後熱重載。

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

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Claude × Obsidian

如何將一長段 Claude 對話捕捉為正式的 Wiki 條目

👤 使用 Obsidian 的知識工作者 ⏱ ~5 min beginner

何時使用: 你進行了一場很棒的 Claude 對話,之後還會用到——不要讓它消失在聊天記錄裡。

前置條件
  • 已安裝 Skill;已設定知識庫路徑 — 在環境變數中設定 OBSIDIAN_VAULT;以 git clone 安裝
步驟
  1. 儲存
    /save the conversation we just had about React Server Components patterns. Title: 'RSC patterns'.✓ 已複製
    → 筆記建立於 /Wiki/RSC-patterns.md,含 frontmatter 與反向連結
  2. 確認連結
    Show me what existing notes the new entry links back to.✓ 已複製
    → 已連結的筆記及其連結依據

結果: Wiki 獲得結構化條目,而非讓對話流入無底洞。

注意事項
  • /save 建立的筆記過長 — Skill 預設壓縮至約 600 字;只有在必要時才傳入 --full
搭配使用: obsidian-mcp-tools

提問前先問 Wiki

👤 長期知識庫持有者 ⏱ ~5 min beginner

何時使用: 你知道自己寫過這方面的內容;先查看知識庫。

步驟
  1. 詢問 Wiki
    /wiki What did I conclude about RSC error boundaries last quarter?✓ 已複製
    → 引用 + 來源筆記連結
  2. 精煉
    Now extend that conclusion with anything you can verify online today, and update the note.✓ 已複製
    → 筆記更新,新增有日期的章節

結果: 知識庫越來越精密,而非越來越冗餘。

注意事項
  • Wiki 有未被更新的過時資訊 — Skill 將最後修改超過 6 個月的內容標記為過時;取回時審查

執行 /autoresearch 為某個主題新增有來源的 Wiki 條目

👤 研究者 / 學生 ⏱ ~30 min intermediate

何時使用: 主題對你是全新的;你想要一份之後可以繼續擴充的筆記式摘要。

步驟
  1. 自動研究
    /autoresearch 'Mixture of Experts in 2026 — recent open-source results'.✓ 已複製
    → 建立含章節、引用與知識庫連結的筆記
  2. 精煉
    Trim to focus on practical training implications.✓ 已複製
    → 精煉後的筆記

結果: 作為未來深度工作起點的知識庫條目。

注意事項
  • 引用可能未完全驗證 — 搭配 last30days-skill 或 arxiv-mcp-server 取得有根據的來源
搭配使用: last30days-skill

組合

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

claude-obsidian-skill + obsidian-mcp-tools

以 MCP 存取知識庫;以 skill 執行工作流程

Use claude-obsidian /save with obsidian-mcp-tools as backend.✓ 已複製
claude-obsidian-skill + last30days-skill

讓 /autoresearch 的來源保持當前且有根據

When /autoresearch runs, fetch sources via last30days first.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
/wiki query 讀取知識庫 0
/save title?, scope? 有用對話結束後 0
/autoresearch topic, depth? 新增有來源的條目 0

成本與限制

運行它的成本

API 配額
不適用
每次呼叫 Token 數
/wiki 輕量;/autoresearch 較重(5-20k)
費用
免費
提示
在 /autoresearch 之前先用 /wiki——避免重做已有的工作以節省 token

安全

權限、密鑰、影響範圍

最小權限: filesystem-read filesystem-write
憑證儲存:
資料出站: 本地端,除非 /autoresearch 取回來源

故障排查

常見錯誤與修復

/save 在知識庫外建立檔案

設定 OBSIDIAN_VAULT 環境變數,或明確傳入 --vault

/wiki 無返回結果

確認知識庫中至少有一篇符合的筆記;或重建 skill 的索引

反向連結無法解析

Wiki 使用 [[標題]] 格式;確認檔案標題完全相符

替代方案

Claude × Obsidian 對比其他方案

替代方案何時用它替代權衡
obsidian-mcp-tools(MCP)你想要基礎建構模組而非工作流程MCP 更底層;此 skill 編碼了固定立場
AgriciDaniel/wp-mcp-ultimate(不同領域)你使用 WordPress 作為知識管理工具不同平台;同一作者

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills