mcp-obsidian
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Установка
{
"mcpServers": {
"mcp-obsidian": {
"command": "uvx",
"args": ["mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
"OBSIDIAN_HOST": "<your_obsidian_host>",
"OBSIDIAN_PORT": "<your_obsidian_port>"
}
}
}
}Сначала установите и включите плагин Local REST API в Obsidian.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к Obsidian через плагин сообщества Local REST API и дает агенту доступ к хранилищу. Агент выводит список файлов в корне и в папках, читает заметки и ищет текст по всему хранилищу. Он может дописывать содержимое в новую или существующую заметку, вставлять текст относительно заголовка, блока или поля frontmatter и удалять файлы. Запуск через uvx или Docker.
Для кого. Для тех, кто ведет заметки в Obsidian и хочет работать с ними через агента.
Подходит, если
- Нужно найти, где в заметках упоминается тема, и кратко пересказать контекст
- Нужно собрать итоги встречи в новую заметку
- Нужно дописать раздел в существующую заметку под нужным заголовком
Не подходит, если
- Obsidian не запущен или плагин Local REST API ставить нельзя
- Хранилище содержит данные, которые нельзя давать агенту на удаление
Пример запроса к агенту
Найди в Obsidian заметки, где упоминается CosmosDB, и объясни, в каком контекстеОграничения
Работает только при запущенном Obsidian с включенным плагином Local REST API и его ключом. Нужен Python 3.11 или новее, сервер несовместим с mcp SDK версии 2.0. Инструмент удаления не спрашивает подтверждения сам по себе.
Как отключить. Удалите блок mcp-obsidian из конфигурации MCP и при желании отключите плагин Local REST API.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OBSIDIAN_API_KEY обязательная, секрет | Ключ плагина Local REST API |
| OBSIDIAN_HOST | Хост Obsidian, по умолчанию 127.0.0.1 |
| OBSIDIAN_PORT | Порт плагина, по умолчанию 27124 |
Проверка безопасности
- Читает и изменяет заметки, может удалять файлы хранилища
Коротко о README
README перечисляет инструменты сервера и дает примеры запросов. Описаны требования к Python и версии mcp SDK, два способа передать ключ API: через конфигурацию или файл .env. Приведены конфигурации для Claude Desktop, запуск в Docker и советы по отладке через MCP Inspector. Лицензия MIT.
Частые вопросы
Где взять ключ API?
В настройках плагина Local REST API внутри Obsidian.
Почему Claude не находит uvx?
Укажите в конфигурации полный путь к uvx, его покажет команда which uvx.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании