Vault Health Mcp

io.github.onetrueclaude-creator由 GitHub 帳號 onetrueclaude-creator 發布v0.2.0更新於 Oct 24, 2026

Obsidian vault structural health: broken links, orphans, missing frontmatter, safe auto-repair.

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

概覽

AI 產生的概覽

一個本機 MCP 伺服器，用來檢查 Obsidian 筆記庫的結構問題——失效的 wikilink、孤立筆記與缺少 frontmatter，並可自動修復安全項目。

可以做什麼
將伺服器指向一個 Obsidian 筆記庫，執行完整結構健康掃描，檢查失效連結、孤立筆記與缺少 frontmatter，也可單獨列出孤立筆記或失效 wikilink。輸出筆記庫統計資訊，例如檔案數、連結數、孤立比例與 frontmatter 覆蓋率。持有 Pro 授權時，可執行自動修復，把失效 wikilink 換成純文字並補上預設 frontmatter 區塊。
適用情境
適合以 Obsidian 管理筆記、希望助理檢視筆記庫結構、找出斷鏈或孤立筆記，並在不需要外掛的情況下套用安全增量修復的情境。
執行需求
以 Python 套件形式在本機執行（Python 3.10+），可透過 uvx 或 pip 安裝，並以參數傳入筆記庫路徑。不需要外掛。選用的 Pro 授權透過 VAULT_HEALTH_LICENSE 環境變數、命令列參數或設定檔提供。
安裝前請注意
修復工具會寫入筆記庫檔案，雖然說明為僅做增量變更：將失效 wikilink 換成純文字並加入預設 frontmatter，並聲稱不會刪除檔案或修改既有 frontmatter 值。Pro 授權是付費憑證，驗證在離線進行。執行修復前建議先備份筆記庫。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

vault-health-mcp

MCP server for Obsidian vault structural health checks.

Find broken wikilinks, orphaned notes, and missing frontmatter — then auto-repair them. Works with any Obsidian vault, no plugins required.

Install

bash
pip install vault-health-mcp

Usage

Claude Code

bash
claude mcp add vault-health -- vault-health-mcp --vault ~/my-vault

Claude Desktop

json
{  "mcpServers": {    "vault-health": {      "command": "uvx",      "args": ["vault-health-mcp", "--vault", "/path/to/vault"]    }  }}

MCP Tools

ToolTierDescription
configure_vaultFreePoint the server at a vault at runtime
check_vault_healthFreeFull structural scan: broken links, orphans, missing frontmatter
find_orphansFreeList all structurally disconnected leaf notes
find_broken_linksFreeList all wikilinks pointing to non-existent files
vault_statisticsFreeFile count, link count, orphan %, frontmatter coverage
repair_vaultProAuto-fix safe issues (add-only, never deletes)

How auto-repair works (Pro)

repair_vault only makes additive changes:

  • Broken [[links]] → replaced with plain text (the link text is preserved)
  • Missing frontmatter → adds a default YAML block with title and type

It never deletes files, removes content, or modifies existing frontmatter values.

Pro tier

The free tier detects every category of vault rot. The Pro tier unlocks repair_vault — one call to fix the safe categories automatically.

License activation — any one of these works:

bash
# 1. Environment variableexport VAULT_HEALTH_LICENSE="eyJhbGc..."
# 2. CLI flagvault-health-mcp --license-key "eyJhbGc..." --vault ~/my-vault
# 3. Config fileecho "eyJhbGc..." > ~/.vault-health-mcp/license.jwt

Licenses are verified fully offline — no phone-home, no activation server. Get a license: [coming soon — Dodo Payments storefront in verification].

Requirements

  • Python 3.10+
  • An Obsidian vault (any size)

License

MIT

來源：README.md，提交 9a67a87

工具

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

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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