mcpField
V
vault-health-mcp

vault-health-mcp

本地服务
github.com/onetrueclaude-creator记忆与知识028 周前更新
代码仓库

关于 vault-health-mcp

vault-health-mcp 是用于检查和维护 Obsidian 知识库结构的 MCP 服务，可查找失效的 wikilink、孤立笔记和缺失的 frontmatter，并提供仅执行增量修改的修复工具。

主要功能

  1. 01扫描失效的 wikilink
  2. 02查找孤立笔记
  3. 03检测缺失的 frontmatter
  4. 04统计知识库结构数据
  5. 05安全修复指定问题

适用场景

  1. 01审查知识库中的失效链接
  2. 02定位结构上断开的笔记
  3. 03检查 frontmatter 覆盖情况
  4. 04在不删除内容的情况下添加安全修复

MCP 相关

向 MCP 客户端提供知识库配置、健康检查、问题查询、统计和修复工具。修复工具属于 Pro 功能，只添加或替换内容，不会删除文件或移除现有内容。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "onetrueclaude-creator-vault-health": {
      "command": "uvx",
      "args": [
        "vault-health-mcp"
      ],
      "env": {
        "VAULT_HEALTH_LICENSE": "<VAULT_HEALTH_LICENSE>"
      }
    }
  }
}
启动命令uvx vault-health-mcp
需要配置的环境变量
VAULT_HEALTH_LICENSE密钥Pro license JWT (optional). Unlocks the repair_vault auto-fix tool. See the README for details.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypivault-health-mcp0.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

vault-health-mcp

用于检查 Obsidian 库结构健康状况的 MCP 服务。

查找失效的双链、孤立笔记和缺失的 frontmatter，然后自动修复。适用于任何 Obsidian 库，无需插件。

安装

pip install vault-health-mcp

使用方法

Claude Code
claude mcp add vault-health -- vault-health-mcp --vault ~/my-vault
Claude Desktop
{
  "mcpServers": {
    "vault-health": {
      "command": "uvx",
      "args": ["vault-health-mcp", "--vault", "/path/to/vault"]
    }
  }
}

MCP 工具

工具层级描述
configure_vault免费在运行时指定服务要检查的库
check_vault_health免费全面检查结构：失效链接、孤立笔记、缺失的 frontmatter
find_orphans免费列出所有结构上不相连的叶节点笔记
find_broken_links免费列出所有指向不存在文件的双链
vault_statistics免费文件数、链接数、孤立笔记占比、frontmatter 覆盖率
repair_vault专业版自动修复安全问题（仅添加内容，绝不删除）

自动修复的工作原理（专业版）

repair_vault 只进行增量更改：

  • 失效的 [[links]] → 替换为纯文本（保留链接文本）
  • 缺失的 frontmatter → 添加包含标题和类型的默认 YAML 块

它绝不会删除文件、移除内容或修改现有的 frontmatter 值。

专业版

免费版可检测库中所有类别的问题。专业版解锁 repair_vault，只需调用一次即可自动修复安全类别的问题。

许可证激活 — 以下任一种方式均可：

# 1. Environment variable
export VAULT_HEALTH_LICENSE="eyJhbGc..."

# 2. CLI flag
vault-health-mcp --license-key "eyJhbGc..." --vault ~/my-vault

# 3. Config file
echo "eyJhbGc..." > ~/.vault-health-mcp/license.jwt

许可证完全离线验证 — 不会向外发送数据，也无需激活服务。获取许可证：[即将推出 — Dodo Payments 商店正在验证中]。

要求

  • Python 3.10+
  • 一个 Obsidian 库（大小不限）

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。