Obsidian MCP Server MCP — 使用場景, 安裝 & 即時演示

為什麼要用

核心特性

八種工具，涵蓋備註、標籤、首要事項和搜尋
追加/前置/覆蓋更新模式—客服人員不必重新產生整個檔案
原子前置物質關鍵級操作
在保險庫中進行全域模糊搜尋
用於更快重複讀取的快取圖層

即時演示

實際使用效果

obsidian-mcp-server.replay ▶ 就緒

0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-server"
        ]
      }
    }
  }
}

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

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

使用場景

實戰用法： Obsidian MCP Server

從任何MCP客戶將想法擷取到今天的每日筆記中

👤 在聊天中生活的Obsidian用戶 ⏱ ~5 min beginner

何時使用： 您正在與Claude對話，並希望在不切換應用程式的情況下將想法儲存在您的保險庫中。

前置條件

啓用本地REST API插件的Obsidian — 社羣外掛程式→安裝「本機REST API」→複製API金鑰
使用OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL配置的MCP客戶端 — 請參閱配置區塊；基本URL通常為http://127.0.0.1 ： 27123

步驟

檢查每日備註是否存在

在Daily/2026-04-17.md下列出備註。✓ 已複製

→ 檔案路徑已確認或「找不到」
追加擷取

Append '- Idea: try X for the caching bug' to Daily/2026-04-17.md.✓ 已複製

→ 追加已確認但不覆蓋先前的條目

結果： 客服人員可以添加的運行日誌，永遠不會毀滅。

注意事項

當您的意思是追加時，使用覆蓋模式 — 始終預設在每日備註上附加或前置；儲存覆蓋以供新草稿使用

搭配使用： filesystem

將一週的備註變成評價文件

👤 知識工作者每週進行審查 ⏱ ~20 min intermediate

何時使用： 你需要在本週零散的音符中進行週五綜合。

前置條件

已標記或註明日期的備註 — 使用# weekly或Daily/資料夾

步驟

搜尋本週備註

全域搜尋：本週在每日/下修改的備註。✓ 已複製

→ 5–7個檔案路徑清單
閱讀每項

閱讀每日備註，並按主題進行摘要。✓ 已複製

→ 主題子彈，而非原始連結
撰寫評價

在評價/2026-W16.md撰寫摘要；新增額外資訊狀態：評價、標籤： [WEEKLY]。✓ 已複製

→ 具有正確前置物質的新檔案

結果： 由原材料製成的每週審查備註，無需手動複製粘貼。

搭配使用： github

整合保險庫中凌亂的標籤

👤 有機發展的保險庫，現在有# Work/# work/# WORK變體 ⏱ ~30 min intermediate

何時使用： 由於重複和幾乎重複，標籤清單太長。

步驟

列出目前標籤

使用obsidian_manage_tags列出所有按用途排序的標籤。✓ 已複製

→ 標籤計數顯示重複項
提出映射

提出一個規範集和舊→新映射。✓ 已複製

→ 小型、可審查的表格
批量申請

確認後，請使用對應重新命名保管庫中的標籤。✓ 已複製

→ 按備註匯總的標籤作業

結果： 您實際上可以瀏覽的清潔標籤分類法。

注意事項

無需備份即可一次重寫數百個筆記 — 首先將保管庫提交到git ；查看差異

搭配使用： git

將網頁剪輯放入研究收件匣並自動標記

👤 研究人員，分析師，任何有快門習慣的人 ⏱ ~15 min beginner

何時使用： 收件匣/資料夾的堆積速度超過處理速度。

前置條件

指定的收件匣/資料夾 — 在保管庫中建立

步驟

列出收件箱

在收件匣/下方列出未標記的備註。✓ 已複製

→ 待處理項目的路徑
分類並標記

針對每個標籤，根據內容建議1至3個標籤，然後套用obsidian_manage_tags。✓ 已複製

→ 透過frontmatter自動新增的標籤

結果： 收件匣保持小巧；新片段會自動組織起來。

搭配使用： fetch

組合

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

obsidian-mcp-server + fetch

使用fetch剪下URL ，然後將其寫入收件匣/

擷取https://...並將已清除的摘要儲存至Inbox/YYYY-MM-DD-title.md ，並附上正確的frontmatter。✓ 已複製

obsidian-mcp-server + github

將合併的公關摘要複製到Projects/<repo>.md

查找本周合並的PR ，並在Projects/acme-api.md中的# # Week 16下追加摘要。✓ 已複製

obsidian-mcp-server + git

版本保管庫和提交批次變更

標籤清理後，在Vault上執行git diff並在提交前進行摘要。✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫
obsidian_read_note	path: str	在編輯或總結備註前，請先閱讀備註內容
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	新增或取代備註內容—除非重新撰寫，否則預設會追加
obsidian_search_replace	path: str, find: str, replace: str	有針對性的筆記內編輯，而無需重新產生整個檔案
obsidian_global_search	query: str, filters?	尋找整個保險庫的備註
obsidian_list_notes	folder?: str	批次作業前列舉資料夾中的筆記
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	原子、關鍵級別的前端物質變化
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	標籤衛生和分類作業
obsidian_delete_note	path: str	移除備註—永久，無法復原

成本與限制

運行它的成本

API 配額: 無外部API —本地REST API在您的Mac/PC上運行
每次呼叫 Token 數: 筆記大小；典型200–3000
費用: 免費
提示: 偏好GLOBAL_SEARCH +隨選閱讀，而不是批次列出整個資料夾。

安全

權限、密鑰、影響範圍

憑證儲存： 僅限env var中的OBSIDIAN_API_KEY —從未提交。將其視為保管庫的本機系統管理權杖。

資料出站： 所有流量均爲localhost → Obsidian本地REST API。沒有來自此伺服器的雲端呼叫。

本機REST API外掛程式會在本機HTTP連接埠上公開您的保管庫；僅綁定到127.0.0.1 ，並僅對本機主機關閉HTTPS。
到達您的OBSIDIAN_API_KEY的攻擊者會在保險庫中獲得完整的讀取/寫入—如果您懷疑洩漏，請旋轉。

故障排查

常見錯誤與修復

ECONNREFUSED 127.0.0.1: 27123

Obsidian未運行或本地REST API插件已禁用。打開Obsidian並啓用插件。

驗證： curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 - 未授權

OBSIDIAN_API_KEY與外掛程式的目前金鑰不符。再次從外掛程式設定複製值。

驗證： Plugin Settings → Local REST API → copy the API key

404在已知文件上

路徑是Vault相對的，並區分大小寫—使用OBSIDIAN_LIST_NOTES確認。

驗證： obsidian_list_notes folder='Daily'

替代方案

Obsidian MCP Server 對比其他方案

替代方案	何時用它替代	權衡
obsidian-plugin-skill	您希望Claude幫助撰寫Obsidian外掛程式，而不是編輯Vault內容	不同的範圍
filesystem MCP	您可以進行原始檔案作業，不需要Obsidian感知的前端物件/標籤API	你失去了原子標籤/前端物質操作

Obsidian MCP Server

為什麼要用

核心特性

即時演示

實際使用效果

安裝

選擇你的客戶端

使用場景

實戰用法： Obsidian MCP Server

從任何MCP客戶將想法擷取到今天的每日筆記中

前置條件

步驟

注意事項

將一週的備註變成評價文件

前置條件

步驟

整合保險庫中凌亂的標籤

步驟

注意事項

將網頁剪輯放入研究收件匣並自動標記

前置條件

步驟

組合

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

工具

此 MCP 暴露的能力

成本與限制

運行它的成本

安全

權限、密鑰、影響範圍

故障排查

常見錯誤與修復

替代方案

Obsidian MCP Server 對比其他方案

更多

資源