istefox/obsidian-mcp-connector

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

119 stars 21 forks Качество 89 Тренд 38MIT

Ваш хранилище Obsidian, открыто для Клода и любого MCP-клиента. Работает внутри Obsidian, семантический поиск на устройстве, нет облака туда и обратно, нет бинарного файла для скачивания.

Обзор

Ваш хранилище Obsidian, доступное для AI-клиентов через протокол Model Context Protocol. MCP-сервер работает на loopback, без бинарного файла для скачивания и без облака туда и обратно. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf и VS Code подключаются к одной и той же конечной точке. - Сервер привязан только к loopback. Чтение и запись Vault проходят через собственные API app.vault и app.metadataCache от Obsidian, поэтому модель разрешений Obsidian всё ещё актуальна. - Сервер — это код плагина, работающий в рендерере Obsidian, который убирает поверхность загрузки и выполнения готового исполняемого файла в цепочке поставок. - Transformers.js запускает модель вложения локально. Нет ключа API, нет требования к Smart Connections. - Транспорт не поддерживает состояния сессии, что делает возможными поверхности инструментов для каждого клиента. Версия 2.0 — это релиз, когда этот разъём перестал ждать следующей версии MCP и начал его обслуживать.

Обзор (машинный перевод)

[! ВНИМАНИЕ] Известная проблема: на Obsidian 1.14.4 окно может загасать во время загрузки плагина. Это затрагивает macOS и Windows, и это сбой рендерера Obsidian внутри Electron 43, которого нет в коде этого плагина. В моих тестах это происходит примерно в одном из десяти загрузок плагинов случайным образом. Перезагрузите Obsidian и снова включите плагин: обычно это работает. Я не видел сбоев на Electron 39.8.3 (установщик Obsidian 1.12.7), так что, думаю, причина в сборке Electron и V8, которые выпускает Obsidian 1.14.4. Пока нет обходного пути со стороны плагинов. Сообщил в Obsidian на их форуме, отслеживается здесь в #597 и #609.

Ваш хранилище Obsidian, доступное для AI-клиентов через протокол Model Context. MCP-сервер работает внутри Obsidian, на лупбэке, без бинарного файла для скачивания и без облачного кругового подключения. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf и VS Code все подключаются к одной и той же конечной точке.

Что нового в версии 3.0.0 · Быстрый старт · Инструменты · Отрисованные результаты поиска · Адаптивная загрузка инструментов · Токены для каждого клиента · Подсказки · Протокол · Клиенты · Устранение неполадок · Безопасность · Для разработчиков

Как это работает

Конфигурации клиента указывают на общий брокер на 127.0.0.1:27200.

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

README

Показан фрагмент оригинального README. Открыть оригинал.

MCP Connector for Obsidian

[!NOTE] Blank window on Obsidian 1.14 (Electron 43): fixed in 3.1.1. If Obsidian’s window went white while this plugin loaded, update to 3.1.1 or later. Both causes were in the plugin. Read with Electron’s own symbol files, the crash reports hold two signatures. The first is V8 stopping inside a read of Node’s AsyncLocalStorage: Node 24 (Electron 40 and later) keeps its frames in a V8 slot that Chromium also writes to, and 3.1.0 no longer uses it inside Obsidian. The second is V8 running out of JavaScript heap: every reload of the plugin kept the previous instance in memory, about 40 MB each, through a $ark global that the plugin’s schema library registers and never removes, and 3.1.1 removes it at unload. On one Mac, toggling the plugin off and on: 3.0.3 crashed on the first reload and 3.1.0-alpha.2 once in 200 (Obsidian 1.14.5, Electron 43.8.3), 3.1.1 never in 420 (Obsidian 1.15.0, Electron 43.8.3). The reporter of #597 confirmed it on Obsidian 1.14.4 with 3.1.1 and closed the issue. #609 stays open until its reporter confirms. Details in ADR-0032 and on the Obsidian forum.

Your Obsidian vault, exposed to AI clients over the Model Context Protocol. The MCP server runs inside Obsidian, on loopback, with no binary to download and no cloud round-trip. Claude Desktop, Claude Code, Cursor, Cline, Continue, Windsurf and VS Code all connect to the same endpoint.

Открыть полный README на GitHub

Установка

npx -y mcp-remote http://127.0.0.1:27200/v1/<route-id>/mcp --header Authorization: Bearer YOUR_TOKEN

Новичок в MCP? Начните с руководства на mcpskill.org →

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

{
  "mcpServers": {
    "obsidian_my_vault": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:27200/v1/<route-id>/mcp",
               "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}