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 分