obsidian-mcp

MCP-сервер, который превращает любой хранилище Obsidian в доступную для ИИ базу знаний.

Чем это отличается от 24+ существующих MCP-серверов для Obsidian:

• Граф-ориентированность — BFS, кратчайший путь, компоненты связности, обнаружение мостов через [[wikilinks]]

• Ноль инфраструктуры — Никакой базы данных, запущенного Obsidian или API-ключей

• Независимость от хранилища — Работает с любым существующим хранилищем, без обязательной структуры

• Запись с учётом обратных ссылок — move_note автоматически обновляет все ссылки по всему хранилищу

• Компактность — 4 зависимости времени выполнения, бандл ~42КБ

Быстрый старт

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Related MCP server: some-vault-some-mcp

Инструменты (12)

Чтение и поиск

Обход графа

Запись и изменение

Конфигурация

По умолчанию конфигурация не требуется. Опциональный .obsidian-mcp.json в корне хранилища:

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

Флаги CLI

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

Как это работает

1. При запуске сканирует все .md-файлы и строит граф в памяти (~1–3 с для 1К заметок)

2. Файловый наблюдатель обнаруживает изменения и инкрементально обновляет граф (~5 мс на изменение)

3. Claude запрашивает граф через MCP-инструменты — повторное сканирование не требуется

4. Операции записи атомарно обновляют и файловую систему, и граф

Жёстко заданные исключения: .obsidian/, .trash/, node_modules/

Разработка

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

Лицензия

MIT