vault-health-mcp

vault-health-mcp

onetrueclaude-creatorMIT
MCP-сервер для диагностики и исправления структурных проблем в хранилище Obsidian. Он находит битые вики-ссылки ([[ссылка]]), заметки-сироты (на которые никто не ссылается) и заметки без обязательного frontmatter. Бесплатная версия даёт полную диагностику. Pro-версия умеет автоматически исправлять безопасные категории — заменять битые ссылки на текст и добавлять недостающий frontmatter. Сервер не требует установки плагинов Obsidian. Работает с любым хранилищем любой сложности. Подходит для разработчиков, писателей и всех, кто использует Obsidian как вторую память и хочет поддерживать порядок без ручного труда.
Obsidian
Открыть на GitHub

Установка

uvx vault-health-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикonetrueclaude-creator
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • configure_vault — задать путь к хранилищу в процессе работы, не перезапуская сервер.
  • check_vault_health — провести полное сканирование хранилища: проверяет каждую заметку на три типа проблем.
  • find_orphans — вывести список заметок, на которые нет ни одной обратной ссылки.
  • find_broken_links — вывести список всех вики-ссылок, которые ведут в никуда.
  • vault_statistics — получить сводку: общее количество файлов, количество ссылок, доля сирот, доля заметок с frontmatter.
  • repair_vault (Pro) — автоматически исправить обнаруженные проблемы. Сервер заменяет текст битых ссылок на обычный текст (без потери смысла), добавляет недостающий frontmatter со стандартными полями. Изменения только аддитивные — ничего не удаляется и не изменяется без необходимости.

Как подключить

  1. Установите сервер через менеджер пакетов Python: pip install vault-health-mcp
  2. Настройте клиент. Пример для Claude Desktop — добавьте в конфигурацию:
{ "mcpServers": { "vault-health": { "command": "uvx", "args": ["vault-health-mcp", "--vault", "/path/to/vault"] } } }

Для Claude Code используйте команду: claude mcp add vault-health -- vault-health-mcp --vault ~/my-vault

Если планируете использовать автоисправление, активируйте Pro-лицензию. Это можно сделать одним из трёх способов: через переменную окружения VAULT_HEALTH_LICENSE, через аргумент --license-key или через файл ~/.vault-health-mcp/license.jwt. Лицензия проверяется полностью офлайн — никаких запросов к внешним серверам.

Перезапустите клиент, чтобы сервер подключился.

Примеры запросов

  • «Проверь здоровье моего хранилища /Users/me/second-brain» — запустит полную диагностику и покажет отчёт.
  • «Найди битые ссылки» — выведет все неработающие вики-ссылки.
  • «Покажи статистику хранилища» — выведет метрики: файлы, ссылки, сироты, frontmatter.
  • «Исправь все проблемы» — запустит repair_vault, если подключена Pro-лицензия.
  • «Какие заметки являются сиротами?» — список изолированных заметок.

Технические детали

Разработчик: onetrueclaude-creator. Язык реализации: Python 3.10+. Транспорт: stdio. Лицензия: MIT. Тарифы: Free (диагностика) и Pro (автоисправление). Совместимые клиенты: любые MCP-клиенты, включая Claude Desktop, Claude Code, Visual Studio Code и другие.

Поделиться