English Français العربية

io.github.onetrueclaude-creator/vault-health-mcp

Registre officiel Santé

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package vault-health-mcp
Claude Code 
claude mcp add vault-health-mcp -e 'VAULT_HEALTH_LICENSE=<your vault_health_license>' -- uvx vault-health-mcp==0.2.0 --vault
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vault-health-mcp": {
            "command": "uvx",
            "args": [
                "vault-health-mcp==0.2.0",
                "--vault"
            ],
            "env": {
                "VAULT_HEALTH_LICENSE": "<your vault_health_license>"
            }
        }
    }
}

Variables d'environnement

  • VAULT_HEALTH_LICENSE secret Pro license JWT (optional). Unlocks the repair_vault auto-fix tool. See the README for details.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. vault-health-mcp
  2. Install
  3. Usage
  4. MCP Tools
  5. How auto-repair works (Pro)
  6. Pro tier
  7. Requirements
  8. License

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

pip install vault-health-mcp

Usage

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 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:

# 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

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

Questions fréquentes

Qu'est-ce que io.github.onetrueclaude-creator/vault-health-mcp ?

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

Comment installer io.github.onetrueclaude-creator/vault-health-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add vault-health-mcp -e 'VAULT_HEALTH_LICENSE=<your vault_health_license>' -- uvx vault-health-mcp==0.2.0 --vault. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.onetrueclaude-creator/vault-health-mcp ?

Oui. Il attend VAULT_HEALTH_LICENSE, à renseigner dans sa configuration.

io.github.onetrueclaude-creator/vault-health-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.onetrueclaude-creator/vault-health-mcp ?

Il est publié par onetrueclaude-creator. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.