CO

coddingtonbear/obsidian-local-rest-api

API development

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

3,1 тыс. stars 362 forks Качество 87 Тренд 46MIT

Безопасный 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 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.

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
Открыть полный README на GitHub

Установка

npx mcp-remote@latest https://127.0.0.1:27124/mcp/ --header Authorization: Bearer <your-api-key>
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "obsidian": { "type": "http", "url": "https://127.0.0.1:27124/mcp/", "headers": { "Authorization": "Bearer <your-api-key>" } } } }