bitbonsai/mcpvault

A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access

解決的問題

MCPVault 讓 AI 助理能直接與本地的 Obsidian Vault 互動。它填補了 AI 客戶端與使用者個人知識庫之間的鴻溝,讓 AI 能夠讀取、搜尋和編輯筆記,而無需執行 Obsidian 應用程式或安裝任何特定的 Obsidian 外掛程式。

運作方式

它作為一個本地的 Model Context Protocol (MCP) 伺服器運作。當 AI 客戶端(如 Claude Desktop 或 Cursor)將其作為 stdio 行程啟動時,MCPVault 會提供一組工具供 AI 呼叫以執行檔案系統操作。它直接與 Vault 的 Markdown 檔案互動,並使用具備 AST 感知的更新機制,確保在編輯 frontmatter 時,其他未更改欄位的格式能被保留。

適用對象

Obsidian 的使用者,希望將其個人筆記和知識庫與 AI 代理和 LLM 客戶端整合,以執行諸如總結研究、管理標籤,或基於現有筆記起草新內容等任務。

特色

  • 全方位工具集:提供 18 種工具,用於執行包含讀取、寫入、修補、刪除和移動筆記,以及管理標籤和 frontmatter 等操作。
  • 進階搜尋:具備多詞匹配和 BM25 重新排序功能,以提供更相關的搜尋結果。
  • 安全性導向:實施嚴格的路徑檢查,以阻擋目錄遍歷攻擊、符號連結逃逸,以及存取如 .obsidian.git 等敏感資料夾。
  • 彈性的寫入模式:支援覆寫、附加和前置模式,以便將內容新增至筆記中。
  • 廣泛的相容性:適用於任何與 MCP 相容的客戶端,包含 Claude Desktop、ChatGPT Desktop (Enterprise+)、Cursor 和 Windsurf。

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • 專案