vault-health-mcp

vault-health-mcp

Obsidian のボルトの構造的な健全性をチェックする MCP サーバーです。

壊れたウィキリンク、孤立したノート、欠落しているフロントマターを見つけて、自動修復します。プラグインは不要で、あらゆる 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	無料	構造全体をスキャンします：壊れたリンク、孤立したノート、欠落しているフロントマター
find_orphans	無料	構造的につながりのない末端ノートをすべて一覧表示します
find_broken_links	無料	存在しないファイルを指すウィキリンクをすべて一覧表示します
vault_statistics	無料	ファイル数、リンク数、孤立ノートの割合、フロントマターの網羅率
repair_vault	Pro	安全な問題を自動修正します（追加のみ、削除はしません）

自動修復の仕組み（Pro）

repair_vault は追加のみの変更を行います：

• 壊れた [[links]] → プレーンテキストに置き換えます（リンクテキストは保持されます）
• フロントマターが欠落している場合 → タイトルとタイプを含むデフォルトの YAML ブロックを追加します

ファイルの削除、コンテンツの削除、既存のフロントマター値の変更は一切行いません。

Pro プラン

無料プランでは、ボルトの劣化に関するすべてのカテゴリを検出できます。Pro プランでは repair_vault が利用可能になり、1 回の呼び出しで安全なカテゴリの問題を自動修正できます。

ライセンスの有効化 — 次のいずれかで有効化できます：

# 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