MCP server for Obsidian
Сервер для взаимодействия с Obsidian через Local REST API плагин, управляющий файлами и содержимым vault.
Описание
Это MCP-сервер на Python для интеграции с Obsidian через плагин Local REST API. Позволяет перечислять файлы и директории, получать содержимое заметок, искать по тексту, вставлять/добавлять/удалять контент, а также удалять файлы. Идеален для автоматизации задач с AI (например, Claude), таких как поиск, суммирование и обновление заметок. Требует API-ключа из плагина Obsidian. Поддерживает конфигурацию через JSON или .env.
Возможности
Перечисление файлов в vault
Список всех файлов и директорий в корневой папке Obsidian vault.
Перечисление файлов в директории
Список файлов и директорий в конкретной папке Obsidian.
Получение содержимого файла
Возврат текста одного файла из vault.
Поиск по vault
Поиск документов по текстовому запросу во всех файлах.
Вставка контента
Вставка текста в существующую заметку относительно заголовка, блока или frontmatter.
Добавление контента
Добавление текста в новый или существующий файл vault.
Удаление файла
Удаление файла или директории из vault.
Установка
Установите и включите плагин Obsidian Local REST API (https://github.com/coddingtonbear/obsidian-local-rest-api), скопируйте API-ключ.
Настройте в claude_desktop_config.json (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mcp-obsidian": {
"command": "uvx",
"args": [
"mcp-obsidian"
],
"env": {
"OBSIDIAN_API_KEY": "<your_api_key_here>",
"OBSIDIAN_HOST": "127.0.0.1",
"OBSIDIAN_PORT": "27124"
}
}
}
}
Альтернатива: создайте .env файл с OBSIDIAN_API_KEY, OBSIDIAN_HOST, OBSIDIAN_PORT.
Для разработки: uv sync.