Repolode
MarkusPfundstein

MarkusPfundstein/mcp-obsidian

MCP-сервер, который позволяет AI-ассистентам читать, искать, дополнять и удалять заметки в хранилище Obsidian через плагин Local REST API.

Звёзды
4,521
Форки
508
Открытые issues
107
Последний коммит
2 месяца назад

Что это?

mcp-obsidian — это MCP-сервер (Model Context Protocol), который подключает AI-клиентов, например Claude Desktop, к хранилищу Obsidian. Он работает через community-плагин Local REST API для Obsidian, поэтому Obsidian должен быть запущен, а плагин — включён и настроен с API-ключом.

После подключения ассистент может просматривать файлы и папки в хранилище, читать содержимое заметок, искать текст во всех файлах, вставлять содержимое относительно заголовка, block reference или поля frontmatter, дописывать данные в новые или существующие файлы, а также удалять файлы и каталоги. Для настройки нужен API-ключ; хост и порт можно указать дополнительно. По умолчанию используются 127.0.0.1 и 27124.

Проект можно запускать с помощью uvx, в локальном окружении uv или в Docker-контейнере, подключающемся к хосту через host.docker.internal. Требуется Python версии 3.11 или новее и версия Python SDK mcp ниже 2.0.

Ключевые возможности

  • 01Показывает файлы и каталоги в корне хранилища или в указанной папке.
  • 02Читает содержимое отдельной заметки целиком.
  • 03Ищет текст во всех файлах хранилища.
  • 04Вставляет содержимое в заметки относительно заголовков, block reference или полей frontmatter.
  • 05Дописывает содержимое в новые или существующие файлы и удаляет файлы или каталоги.

Сценарии использования

  • Попросить AI-ассистента обобщить заметки в Obsidian или объяснить их содержание.
  • Найти в хранилище все упоминания темы и изучить контекст вокруг них.
  • Автоматически создать новую заметку с итогами встречи на основе существующих заметок.
  • Поручить AI-ассистенту вести и обновлять заметки в личной базе знаний.

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

  1. 1

    Установите и включите плагин сообщества Obsidian Local REST API, затем скопируйте его API-ключ

  2. 2

    Добавьте сервер в конфигурацию клиента MCP, задав OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT

  3. 3

    Запустите опубликованный сервер с помощью uvx

    uvx mcp-obsidian

Что важно знать

  • Необходимо установить плагин сообщества Obsidian Local REST API и запустить его в Obsidian.
  • Требуется Python версии 3.11 или новее, а версия зависимости mcp должна быть ниже 2.0.

В подборках

Темы

Частые вопросы

Что такое mcp-obsidian?
MCP-сервер, который позволяет AI-ассистентам читать, искать, дополнять и удалять заметки в хранилище Obsidian через плагин Local REST API. mcp-obsidian — это MCP-сервер (Model Context Protocol), который подключает AI-клиентов, например Claude Desktop, к хранилищу Obsidian. Он работает через community-плагин Local REST API для Obsidian, поэтому Obsidian должен быть запущен, а плагин — включён и настроен с API-ключом.
mcp-obsidian можно использовать бесплатно? Какая у него лицензия?
mcp-obsidian распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
mcp-obsidian всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в mcp-obsidian — 31 авг. 2026 г..
Для чего можно использовать mcp-obsidian?
Попросить AI-ассистента обобщить заметки в Obsidian или объяснить их содержание. Найти в хранилище все упоминания темы и изучить контекст вокруг них. Автоматически создать новую заметку с итогами встречи на основе существующих заметок. Поручить AI-ассистенту вести и обновлять заметки в личной базе знаний.
Как установить mcp-obsidian?
Установите и включите плагин сообщества Obsidian Local REST API, затем скопируйте его API-ключ Добавьте сервер в конфигурацию клиента MCP, задав OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT Запустите опубликованный сервер с помощью uvx: uvx mcp-obsidian
Где скачать mcp-obsidian?
Исходный код и инструкции по установке — на GitHub: https://github.com/MarkusPfundstein/mcp-obsidian

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты