English Français العربية

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

السجل الرسمي الصحة

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.onetrueclaude-creator/vault-health-mcp؟

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

كيف أثبّت io.github.onetrueclaude-creator/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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.onetrueclaude-creator/vault-health-mcp إلى مفتاح API؟

نعم. يتطلب VAULT_HEALTH_LICENSE، وتضبطها في إعداداته.

هل io.github.onetrueclaude-creator/vault-health-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.onetrueclaude-creator/vault-health-mcp؟

ينشره onetrueclaude-creator. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.