Obsidian MCP

Obsidian MCP

seynurmammad0vMIT
1 звёзд
Obsidian MCP — сервер, который превращает ваше хранилище Obsidian в граф знаний, доступный для запросов через AI-ассистентов. В отличие от других решений, он не требует запущенного Obsidian, базы данных или API-ключей. Достаточно указать путь к папке с заметками. Сервер строит граф на основе вики-ссылок ([[wikilinks]]) между заметками. Claude, Claude Code и другие MCP-совместимые ассистенты могут исследовать связи, находить кратчайшие пути, анализировать структуру и редактировать файлы с автоматическим обновлением обратных ссылок.
Ai-mlObsidian
Открыть на GitHub

Установка

npx -y @smammadov/obsidian-mcp

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

Общее

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

Технологии

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

Описание

Возможности

  • Получать общую статистику хранилища: количество заметок, тегов, ссылок, сирот (не связанных заметок) и связных компонентов.
  • Читать содержимое заметки вместе с frontmatter, списком входящих и исходящих ссылок и разделами.
  • Искать заметки по комбинации тегов, папки, полей frontmatter и ключевых слов.
  • Обходить граф связей: получать соседей заметки, выполнять BFS или DFS на глубину до 10 переходов с фильтрацией по тегам.
  • Находить кратчайший путь между двумя заметками через цепочку ссылок.
  • Анализировать граф: определять связные компоненты, сироты, мосты, хабы и битые ссылки.
  • Создавать новые заметки с произвольным содержимым и frontmatter.
  • Редактировать заметки: добавлять текст в начало/конец, заменять раздел, обновлять frontmatter.
  • Переименовывать или перемещать заметки — все обратные ссылки обновляются автоматически.
  • Удалять заметки с отчётом о возникших битых ссылках.
  • Управлять тегами: добавлять, удалять, переименовывать глобально по всему хранилищу.

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

Установите и запустите сервер одной командой, указав путь к вашему хранилищу Obsidian:

npx -y @smammadov/obsidian-mcp --vault /путь/к/хранилищу

Для интеграции с Claude Desktop добавьте в файл конфигурации claude_desktop_config.json:

{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "@smammadov/obsidian-mcp", "--vault", "/путь/к/хранилищу"]
}
}
}

Для Claude Code используйте команду:

claude mcp add obsidian -- npx -y @smammadov/obsidian-mcp --vault /путь/к/хранилищу

После настройки перезапустите клиент.

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

  • «Покажи статистику моего хранилища: сколько заметок, какие теги самые популярные, есть ли заметки без связей.»
  • «Найди кратчайшую цепочку вики-ссылок между заметками „Машинное обучение“ и „Квантовые вычисления“ и выведи её на экран.»
  • «Создай новую заметку „Идеи для проекта“ с тегами #идея #2025 и добавь раздел „Цели“ с тремя пунктами.»
  • «Перемести заметку из папки „Черновики“ в папку „Готово“ и обнови все ссылки на неё в других заметках.»

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

  • Язык разработки: TypeScript
  • Транспортный протокол: MCP stdio
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, Claude Code, любые MCP-совместимые ассистенты
  • Зависимости: всего 4 внешние библиотеки, размер бандла около 42 КБ

Поделиться