StevenStavrakis/obsidian-mcp

A simple MCP server for Obsidian

解決的問題

允許 AI 助手安全地讀取和修改 Obsidian 倉庫。作為橋樑,它讓基於大語言模型的工具能在不開啟 Obsidian 應用程式的情況下與您的個人知識庫互動。

工作原理

此專案基於 Model Context Protocol (MCP) 實作了一個本地伺服器。它透過直接存取檔案系統上的 Markdown 檔案來連接 Obsidian 倉庫。為確保安全,它使用明確的倉庫路徑白名單,並嚴格驗證所有檔案路徑,防止對系統其餘部分的未授權存取。它還透過事務系統管理檔案變更,記錄變更日誌,使用 etags 檢查衝突,並提供對已刪除或修改的筆記的復原機制。

適用對象

希望將筆記與相容 MCP 的 AI 助手整合,以實現筆記自動化、搜尋與組織的 Obsidian 使用者。

主要亮點

  • 事務安全性:檔案變更會被記錄並原子性取代,內建復原系統可恢復到先前版本。
  • 全面的工具集:包含讀取、建立、編輯、搜尋、管理筆記、目錄與標籤的工具。
  • 智慧連結處理:當筆記被移動或重新命名時,自動更新維基連結、嵌入與 Markdown 連結。
  • 嚴格的安全性:阻止符號連結,保留系統目錄,並拒絕無效路徑,確保 AI 無法存取設定倉庫以外的檔案。
  • 協定相容性:相容於現代與舊版 MCP 客戶端版本。

相關

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