mcp-obsidian
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
- 4 507 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает и изменяет заметки, может удалять файлы хранилища
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-obsidianОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает и изменяет заметки, может удалять файлы хранилища
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к Obsidian через плагин сообщества Local REST API и дает агенту доступ к хранилищу. Агент выводит список файлов в корне и в папках, читает заметки и ищет текст по всему хранилищу. Он может дописывать содержимое в новую или существующую заметку, вставлять текст относительно заголовка, блока или поля frontmatter и удалять файлы. Запуск через uvx или Docker.
Для кого. Для тех, кто ведет заметки в Obsidian и хочет работать с ними через агента.
Подходит, если
- Нужно найти, где в заметках упоминается тема, и кратко пересказать контекст
- Нужно собрать итоги встречи в новую заметку
- Нужно дописать раздел в существующую заметку под нужным заголовком
Не подходит, если
- Obsidian не запущен или плагин Local REST API ставить нельзя
- Хранилище содержит данные, которые нельзя давать агенту на удаление
Пример запроса к агенту
Найди в Obsidian заметки, где упоминается CosmosDB, и объясни, в каком контекстеMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
OBSIDIAN_API_KEYобязательная, секрет- Ключ плагина Local REST API
OBSIDIAN_HOST- Хост Obsidian, по умолчанию 127.0.0.1
OBSIDIAN_PORT- Порт плагина, по умолчанию 27124
Ограничения
Работает только при запущенном Obsidian с включенным плагином Local REST API и его ключом. Нужен Python 3.11 или новее, сервер несовместим с mcp SDK версии 2.0. Инструмент удаления не спрашивает подтверждения сам по себе.
Как отключить. Удалите блок mcp-obsidian из конфигурации MCP и при желании отключите плагин Local REST API.
Частые вопросы
Где взять ключ API?
В настройках плагина Local REST API внутри Obsidian.
Почему Claude не находит uvx?
Укажите в конфигурации полный путь к uvx, его покажет команда which uvx.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Obsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Local REST API для Obsidian
Local REST API for Obsidian
Плагин Obsidian с защищенным REST API и встроенным MCP-сервером: агент читает, ищет и точечно правит заметки хранилища прямо из Claude Code или Cursor
Obsidian MCP Plugin
obsidian-mcp-plugin
Плагин Obsidian: сервер MCP работает внутри Obsidian, восемь инструментов для хранилища, поиска и графа. Установка через каталог плагинов или .mcpb
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-obsidian (эта запись) | нет | API-ключ | 4 507 | |
| Obsidian MCP Server | нет | API-ключ | 700 | поиск и правка |
| Obsidian MCP Plugin | нет | API-ключ | 467 | сервер MCP работает внутри запущенного Obsidian |
| Obsidian MCP | нет | не нужна | 747 | локальный сервер для указанных папок хранилища Obsidian |
Коротко о README
README перечисляет инструменты сервера и дает примеры запросов. Описаны требования к Python и версии mcp SDK, два способа передать ключ API: через конфигурацию или файл .env. Приведены конфигурации для Claude Desktop, запуск в Docker и советы по отладке через MCP Inspector. Лицензия MIT.