Obsidian MCP

Obsidian MCP

seynurmammad0vv1.0.3MIT
1 звёзд
Obsidian MCP — сервер, который превращает ваше хранилище Obsidian в граф знаний, доступный для запросов через AI-ассистентов. В отличие от других решений, он не требует запущенного Obsidian, базы данных или API-ключей. Достаточно указать путь к папке с заметками. Сервер строит граф на основе вики-ссылок ([[wikilinks]]) между заметками. Claude, Claude Code и другие MCP-совместимые ассистенты могут исследовать связи, находить кратчайшие пути, анализировать структуру и редактировать файлы с автоматическим обновлением обратных ссылок.
  • Сервер сообщества
  • Локальный запуск (stdio)
  • TypeScript
  • Лицензия MIT
  • Обновлён 17 марта 2026 г.
Подключение

Подключить Obsidian MCP

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smammadov/obsidian-mcp"
      ]
    }
  }
}

Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.

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

Общее

  • СтатусСообщество
  • Разработчикseynurmammad0v
  • Версияv1.0.3
  • ЛицензияMIT
  • Последний релиз17.03.2026
  • Активность источника17.03.2026

Технологии

  • Языки
    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 КБ

Поделиться