Obs186｜Local REST API & MCP Server 4.0 大改版！用自然語言搜尋筆記、寫入檔案、管理標籤

我在Obs105-外掛Local REST API提供外部整合服務介紹了Local REST API外掛，透過瀏覽器外掛Obsidian Web能將網址或許選取文字加入指定的筆記，但升級Local REST API外掛到 4.0 版之後，瀏覽器的操作就失敗了。

查看的結果是：Local REST API 4.0版開始大改版，它不只提供了HTTP Server (供瀏覽器使用)，同時也提供了MCP Server (供AI Agent使用)的功能，同時瀏覽器外掛的設定也變更了。

1. AI Agent功能示範

內容有 "MCP server" 的筆記, 將結果寫入 030-Inbox/list.md

• 因為AGENTS.md 裡有規則：「簡單任務直接做，不需要先「問路」。」，因此優先使用OLpenCode native tool，即MCP工具

將下列查詢後的內容寫入 030-Inbox/mcp.md:

什麼是MCP?

1.1. Obsidian CLI 間的差異

MCP工具更直接，Obsidian CLI透過 Skill 運作

| 面向 | Obsidian CLI (obsidian 命令) | Local REST API & MCP Server |

| :------- | :---------------------------------- | :---------------------------------------------------------------- |

| 性質 | Obsidian 官方內建功能 | 第三方社群插件 (coddingtonbear/obsidian-local-rest-api) |

| 啟用方式 | 設定 → 一般 → 啟用 Command line interface | 安裝社群插件 → 設定 → Local REST API |

| 通訊協定 | 專有 CLI 協議（子行程通訊） | HTTP(S) REST API + MCP (Streamable HTTP) |

| 端點 | 無（直接與 Obsidian 程序通訊） | http://127.0.0.1:27123/ (HTTP) / https://127.0.0.1:27124/ (HTTPS) |

| 認證 | 無（OS 層級行程通訊） | Bearer token (API key) |

| 特點 | 有開發者工具、插件管理、主題、Sync、Publish等功能 | obsidian_vault_patch 可以精準定位 heading / block / frontmatter 做增刪改 |

2. MCP Server功能與設定

2.1. MCP 提供功能

| 工具 | 功能 |

| ------------------------------- | --------------------------- |

| obsidian_vault_list | 列出資料夾內容 |

| obsidian_vault_read | 讀取檔案內容 |

| obsidian_vault_write | 寫入檔案 |

| obsidian_vault_patch | 修補檔案特定區段 |

| obsidian_vault_delete | 刪除檔案 |

| obsidian_vault_move | 移動/重新命名檔案 |

| obsidian_vault_get_document_map | 取得文件結構（標題、區塊參考、frontmatter） |

| obsidian_vault_append | 附加內容到檔案結尾 |

| obsidian_search_simple | 簡易搜尋 |

| obsidian_search_query | JsonLogic 進階搜尋 |

| obsidian_tag_list | 列出所有標籤 |

2.2. AI Agent設定

• Claude與Cursor可參考GitHub

• OpenCode設定如下：

  "mcp": {

    "obsidian": {  

      "type": "remote",

      "url": "http://127.0.0.1:27123/mcp/",

      "enabled": true,

      "headers": {

        "Authorization": "Bearer YOUR_API_KEY",

      }

    }  

  }

• 因為 Local REST API 使用自簽憑證，直接使用 http:// 比較簡單

• 啟動 opencode 前，先執行下列命令的話，"url" 即可使用 "https://127.0.0.1:27124/mcp/"

set NODE_TLS_REJECT_UNAUTHORIZED=0



rem 永久設定環境變數

setx NODE_TLS_REJECT_UNAUTHORIZED 0

3. Obsidian安裝與啟用

• 在社群外掛搜尋 local REST API，安裝並啟用

• 設定→搜尋local REST API→複製 API Key: Bearer YOUR_API_KEY

• 勾選 Enable non-encrypted (HTTP) server

4. 瀏覽器擴充Obsidian Web設定

• Obsidian Web圖示右鍵→擴充功能選項→修改現有 Templates

4.1. Local REST API 3.x 原有設定

• 新增內容：PATCH /vault/資料夾/筆記.md

  • 在筆記裡找到 2026 標題，新增內容到標題內的開頭

  • HTTP Headers格式在4.0已變更

4.2. Local REST API 4.x 新設定

• 新增內容：PATCH /vault/資料夾/筆記.md

  • 在筆記裡找到 2026 標題，新增內容到標題內的開頭

• Operation: append (加在標題內最後面), prepend (加在標題內第一行), replace

• Target-Type: heading, block, frontmatter

  • heading時必須用 heading1::heading2 的格式，由上到下指定heading

• Content-Type: 不能使用 text/plain→可使用 text/markdown 或 application/json

5. 💡 相關鏈接

✅ 解說文章(繁體中文): https://jdev.tw/blog/9217/

✅ Explanation article(English)

✅ 解説記事(日本語)

✅ Obsidian Web 瀏覽器擴充 Obsidian Web - Chrome 線上應用程式商店

✅ GitHub local-rest-api with MCP: https://github.com/coddingtonbear/obsidian-local-rest-api

6. 教學影片

https://youtu.be/xirWt7htxms

＃＃