/ 目錄 / 演練場 / Obsidian MCP Tools
● 社群 jacksteamdev ⚡ 即開即用

Obsidian MCP Tools

作者 jacksteamdev · jacksteamdev/obsidian-mcp-tools

為你的 Obsidian 知識庫新增真正的 MCP 介面——透過 Smart Connections 進行語義搜尋、執行 Templater 提示範本、完整的檔案 CRUD——無需離開編輯器。

Obsidian MCP Tools 以社群外掛與 MCP 橋接器的形式發布,讓 Claude 能語義搜尋你的知識庫(透過 Smart Connections 整合)、執行帶有提示的 Templater 範本,並建立、讀取、更新筆記。本地優先——不會將你的筆記上傳至 SaaS——並與你很可能已在使用的 Obsidian 社群外掛生態系整合。

為什麼要用

核心特性

即時演示

實際使用效果

obsidian-mcp-tools.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

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

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

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

使用場景

實戰用法: Obsidian MCP Tools

如何真正查詢你的第二大腦,而不是用關鍵字搜尋

👤 擁有 1000 篇以上筆記的 Obsidian PKM 使用者 ⏱ ~20 min intermediate

何時使用: 你知道幾個月前寫過某件事,但關鍵字搜尋一直找不到。

前置條件
  • Obsidian + 此外掛 + Smart Connections 外掛 — 從社群外掛安裝兩者;Smart Connections 首次執行時會建立索引
步驟
  1. 確認索引
    Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ 已複製
    → 已索引的筆記數量;使用的嵌入模型
  2. 語義召回
    Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ 已複製
    → 5 篇依語義相符度排序的筆記,含摘要
  3. 整合
    Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ 已複製
    → 新筆記已建立;反向連結可正常解析

結果: 一個以概念而非關鍵字回答的第二大腦。

注意事項
  • 語義召回會帶出敏感的個人筆記 — 在 Smart Connections 中使用 Obsidian 的 excludedFolders 設定排除私密資料夾
搭配使用: humanizer-skill

讓 Claude 執行 Templater 範本並自動填入提示

👤 使用範本的 Obsidian 進階使用者 ⏱ ~10 min intermediate

何時使用: 你有一個「專案啟動」Templater 範本需要填入 5 個提示;你寧願讓 Claude 來協調。

前置條件
  • 已安裝 Templater 且設定好範本 — 標準社群外掛
步驟
  1. 列出範本
    What Templater templates are available?✓ 已複製
    → 含提示描述的範本清單
  2. 自動填入並執行
    Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ 已複製
    → 使用範本建立新筆記;提示已填入

結果: 從對話中執行範本,而非透過彈窗操作。

注意事項
  • 部分 Templater 指令是非同步的,需要時間 — MCP 工具會等待完成——但一次呼叫中不要串連太多

從昨日行事曆與任務自動建立每日筆記

👤 注重生產力的 Obsidian 使用者 ⏱ ~15 min intermediate

何時使用: 你每天早上都在編輯相同的「每日」範本——將它自動化。

步驟
  1. 取得今日資料
    Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ 已複製
    → 識別出待延續的任務與今日行程
  2. 撰寫每日筆記
    Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ 已複製
    → 筆記已建立並開啟

結果: 5 秒內每日筆記準備就緒。

注意事項
  • 若同一任務出現在兩天中,延續時可能重複 — 寫入前依行文字去重
搭配使用: google-calendar

組合

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

obsidian-mcp-tools + google-calendar

建立包含當天行程的每日筆記

Make today's daily note. Include calendar events under '## Today'.✓ 已複製
obsidian-mcp-tools + github

將專案看板鏡像到知識庫筆記

Sync GitHub project XYZ tasks to /Projects/XYZ.md as a checklist.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
search_semantic query, k? 概念層級的召回 1 Smart Connections query
read_note path 取得單篇筆記 free
write_note path, content, mode: 'create'|'append'|'overwrite' 建立或更新筆記 free
list_templates (none) 了解可執行的範本 free
run_templater template_name, prompt_answers: {} 執行範本化的工作流程 free

成本與限制

運行它的成本

API 配額
本地端——若 Smart Connections 使用雲端服務則受其限制
每次呼叫 Token 數
每篇筆記 100–1500 個 token
費用
免費(外掛本身);Smart Connections 有免費本地版與付費雲端版
提示
在 Smart Connections 中使用本地嵌入選項,避免按次計費

安全

權限、密鑰、影響範圍

憑證儲存: 僅限本地外掛;不遠端儲存
資料出站: 本地端——除非 Smart Connections 設定為使用雲端嵌入

故障排查

常見錯誤與修復

MCP 工具未顯示

確認 Obsidian 外掛已啟用且 MCP 橋接器處理程序正在執行

驗證: 查看外掛狀態列;重新啟動 Obsidian
search_semantic 返回空結果

Smart Connections 的嵌入任務可能尚未完成——查看其進度

驗證: 開啟 Smart Connections 側邊欄
write_note 失敗,提示「路徑在知識庫外」

路徑相對於知識庫根目錄;不要使用絕對路徑

替代方案

Obsidian MCP Tools 對比其他方案

替代方案何時用它替代權衡
ergut/mcp-logseq你使用的是 Logseq 而非 Obsidian不同的生態系;概念相同
AgriciDaniel/claude-obsidian(skill)你想要基於檔案 IO 之上的 skill 形態工作流程Skill 是更高層次的抽象;此 MCP 是基礎建構模組

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

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