Obsidian MCP

io.github.seynurmammad0v由 GitHub 帳號 seynurmammad0v 發布v1.0.3更新於 Oct 25, 2026

Turns Obsidian vaults into AI-queryable knowledge graphs with 12 tools

已驗證STDIO僅桌面檔案與儲存知識與記憶

概覽

AI 產生的概覽

一個本機 MCP 伺服器，把 Obsidian 筆記庫索引成連結圖譜，讓助理讀取、搜尋、遍歷並編輯筆記及其雙向連結。

可以做什麼
讀取與探索筆記：筆記庫統計、含 frontmatter、連結、反向連結與各章節的完整內容，以及標籤、資料夾、frontmatter 與關鍵字的組合搜尋。遍歷連結圖譜：直接相鄰筆記、指定深度的 BFS/DFS、兩篇筆記間的最短連結路徑，以及連通分量、孤立筆記、橋接、樞紐與失效連結分析。寫入與整理：建立筆記，附加、前置或取代章節，更新 frontmatter，移動或重新命名筆記並自動更新反向連結，刪除筆記，以及全庫新增、移除或重新命名標籤。
適用情境
適合以 Obsidian 筆記庫累積知識、並希望助理跨連結筆記回答問題、梳理筆記間關係，或執行移動筆記並修正引用這類批次修改的情境。它著重於個人知識庫的圖譜式探索，而非一般檔案管理。
執行需求
透過 npx 以 stdio 在本機執行，需要 Node.js。必須以 --vault 參數指定筆記庫路徑。不需要資料庫、執行中的 Obsidian、API 金鑰或環境變數；選用設定放在筆記庫根目錄的 .obsidian-mcp.json 檔案中。
安裝前請注意
寫入類工具會變更磁碟檔案：建立、修補、移動與刪除筆記，以及全庫重新命名標籤。移動筆記會改寫整個筆記庫中的引用，刪除只回報失效連結而不會修復。只指向你願意被修改的筆記庫，並保留備份或版本控制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Obsidian MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

obsidian-mcp

MCP server that turns any Obsidian vault into an AI-queryable knowledge graph.

What makes this different from the 24+ existing Obsidian MCP servers:

  • Graph-first — BFS, shortest path, connected components, bridge detection via [[wikilinks]]
  • Zero infrastructure — No database, no Obsidian running, no API keys
  • Vault-agnostic — Works with any existing vault, no required structure
  • Backlink-aware writes — move_note auto-updates all references across the vault
  • Tiny — 4 runtime dependencies, ~42KB bundle

Quick Start

bash
npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "obsidian": {      "command": "npx",      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]    }  }}

Claude Code

bash
claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Tools (12)

Reading & Discovery

ToolDescription
vault_statsOverview: total notes, tags, links, orphans, components, top tags/hubs
read_noteFull content + frontmatter + links + backlinks + sections
search_notesFilter by tags, folder, frontmatter, keyword. All combinable

Graph Traversal

ToolDescription
graph_neighborsDirect links + backlinks for a note
graph_traverseBFS/DFS from a note, N hops deep with tag filtering
graph_shortest_pathShortest link chain between two notes
graph_analyzeComponents, orphans, bridges, hubs, dead links

Writing & Manipulation

ToolDescription
create_noteCreate with content + frontmatter
patch_noteAppend, prepend, or replace a section. Update frontmatter
move_noteRename/move + auto-update all backlinks across vault
delete_noteDelete + report broken links
manage_tagsAdd/remove/rename tags (vault-wide rename supported)

Configuration

Zero-config by default. Optional .obsidian-mcp.json in vault root:

json
{  "ignore": ["templates/", "daily-notes/", ".trash/"],  "watchDebounce": 100,  "maxTraversalDepth": 10,  "maxSearchResults": 500}

CLI Flags

--vault <path>       Path to Obsidian vault (required)--verbose            Enable debug logging--log-level <level>  error | warn | info | debug (default: info)

How It Works

  1. On startup, scans all .md files and builds an in-memory graph (~1-3s for 1k notes)
  2. File watcher detects changes and updates the graph incrementally (~5ms per change)
  3. Claude queries the graph via MCP tools — no re-scanning needed
  4. Write operations update both the filesystem and the graph atomically

Hardcoded exclusions: .obsidian/, .trash/, node_modules/

Development

bash
npm installnpm test              # Run 66 testsnpm run build         # Build to dist/npm run dev -- --vault test/fixtures/vault  # Dev mode

License

MIT

來源：README.md，提交 8008844

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分