Локальный слой памяти: AI-ассистенты, например Claude и Cursor, могут читать и записывать заметки в обычных Markdown-файлах через MCP.
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
Установите и включите плагин сообщества Obsidian Local REST API, затем скопируйте его API-ключ
- 2
Добавьте сервер в конфигурацию клиента MCP, задав OBSIDIAN_API_KEY, OBSIDIAN_HOST и OBSIDIAN_PORT
- 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 обновляется ежедневно.
Похожие проекты
Шаблон хранилища Obsidian, который помогает AI-агентам для программирования, например Claude Code, сохранять память между сессиями.
Постоянная память для Claude Code, Codex и других AI-агентов в виде обычных Markdown-файлов в хранилище Obsidian.
Локальный ИИ-ассистент для автоматизации: личное NAS-хранилище заметок, файлов, напоминаний и памяти, а также более 40 инструментов для ИИ-клиентов через MCP.
Плагин для Claude Code, Codex и OpenCode, который собирает базы знаний для Obsidian: проводит параллельные исследования, загружает источники и отвечает на вопросы.
Самостоятельно размещаемый AI-ассистент в Telegram, который сохраняет голосовые заметки, фото и сообщения в markdown-хранилище и позволяет искать их позже.