
coddingtonbear/obsidian-local-rest-api
API developmentЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Безопасный REST API и сервер Model Context Protocol (MCP) для вашего хранилища.
Обзор
Дайте своим скриптам, расширениям браузера и агентам ИИ прямой доступ к вашему хранилищу Obsidian через защищённый, аутентифицированный REST API. https://coddingtonbear.github.io/obsidian-local-rest-api/ Получите доступ к своему хранилищу через или — оба интерфейса показывают одинаковые основные возможности, поэтому скрипты, расширения браузера и AI-агенты говорят на одном языке. - — полный CRUD на любом файле в вашем хранилище, включая бинарные файлы — — нацеливайтесь на заголовок, ссылку на блок или клавишу фронтматера и добавляйте, препрейдите или заменяйте только этот раздел, не касаясь остальной части файла — — простой полнотекстовый поиск или структурированные запросы JsonLogic по метаданным заметок (фронтматтер, теги, путь, содержимое) — — читать или записывать любую заметку, которая сейчас открыта в Obsidian — — получать или создавать ежедневные, еженедельные, ежемесячные, квартальные и годовые заметки — — запускайте любую команду Obsidian, как если бы вы использовали палитру команд — — перечислите все теги в вашем хранилище с учётом использования — — скажите Obsidian открыть конкретную заметку в интерфейсе — —...
Обзор (машинный перевод)
Дайте своим скриптам, расширениям браузера и агентам ИИ прямой доступ к вашему хранилищу Obsidian через защищённый, аутентифицированный REST API.
-
Интерактивная документация API: https://coddingtonbear.github.io/obsidian-local-rest-api/
-
Страница сообщества Obsidian: https://community.obsidian.md/plugins/obsidian-local-rest-api/
-
Что ты можешь сделать
-
Быстрый старт
- API REST
- Клиенты MCP
- Код Клода
- Claude Desktop
- Курсор
- Другие клиенты
- Обзор API
- Каталог конфигурации закрыт
- Неудачная аутентификация замедлена
- Условные записи
- Клиенты браузера и заголовки ответов
- Нотки по исправлению
- Режим сырого контента
- Нацеливание на конкретные участки
- Поиск
- Потоки событий
- Состояние сервера
- MCP (Протокол контекста модели)
- Изменения протокола
- Подключение клиента
- Доступные инструменты
- Бинарные файлы и вложения
- Подписанные URL-адреса
- Доступные ресурсы
- Расширения API
- API типизированного расширения
- Повторная регистрация после перезагрузки хоста
- Инструменты, ресурсы и запросы MCP
- Документирование маршрутов
- Подресурсы под примечанием
- Мероприятия расширения
- Состояние расширения
- Известные расширения
- Вклад
- Кредиты
Что ты можешь сделать
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Local REST API with MCP
Give your scripts, browser extensions, and AI agents a direct line into your Obsidian vault via a secure, authenticated REST API.
-
Interactive API docs: https://coddingtonbear.github.io/obsidian-local-rest-api/
-
Obsidian Community page: https://community.obsidian.md/plugins/obsidian-local-rest-api/
What you can do
Access your vault through the REST API or the built-in MCP server — both interfaces expose the same core capabilities, so scripts, browser extensions, and AI agents all speak the same language.
- Read, create, update, or delete notes — full CRUD on any file in your vault, including binary files
- Surgically patch specific sections — target a heading, block reference, or frontmatter key and append, prepend, replace, delete, or move just that section without touching the rest of the file
- Search your vault — simple full-text search or structured JsonLogic queries against note metadata (frontmatter, tags, path, content)
- Follow vault events — subscribe to Obsidian events (a note created, its frontmatter changed, a file opened) as a filtered Server-Sent Events stream
Установка
npx mcp-remote@latest https://127.0.0.1:27124/mcp/ --header Authorization: Bearer <your-api-key>Конфигурация
{
"mcpServers": {
"obsidian": {
"type": "http",
"url": "https://127.0.0.1:27124/mcp/",
"headers": {
"Authorization": "Bearer <your-api-key>"
}
}
}
}