IO

istefox/obsidian-mcp-connector

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

119 stars 21 forks 品質 89 トレンド 38MIT

ObsidianのVaultはClaudeや他のMCPクライアントに公開されています。Obsidian内で動作し、デバイス内でセマンティック検索が可能、クラウドの往復もダウンロードもできません。

概要

あなたのObsidianボールトは、Model Context Protocolを通じてAIクライアントに公開されます。MCPサーバーはループバックで動作し、ダウンロード用のバイナリやクラウド往復もありません。Claude Desktop、Claude Code、Cursor、Cline、Continue、Windsurf、VS Codeはすべて同じエンドポイントに接続されています。 - サーバーはループバックのみにバインドします。Vaultの読み書きはObsidian独自のapp.vaultおよびapp.metadataCacheのAPIを経由するため、Obsidianの権限モデルは依然として適用されます。- サーバーはObsidianのレンダラーで動作するプラグインコードであり、プリビルド実行ファイルのダウンロードと実行のサプライチェーン処理を省きます。- Transformers.js埋め込みモデルをローカルで実行します。APIキーやスマート接続の要件はありません。- トランスポートはセッション状態を保持せず、これがクライアントごとのツールサーフェスを可能にします。 2.0は、このコネクタが次のMCPリビジョンを待つのをやめて、それにサービスを開始したリリースです。

概要(AI 翻訳)

[!警告] 既知の問題:Obsidian 1.14.4では、このプラグインの読み込み中にウィンドウが真っ白になることがあります。 macOSとWindowsに影響があり、ObsidianのレンダラーがElectron 43内でクラッシュする現象で、このプラグインのコード自体ではありません。私のテストでは、10回のプラグインロードのうち1回ほどランダムに発生します。Obsidianを再起動して再度プラグインを有効にすると、通常はうまくいきます。Electron 39.8.3(Obsidian インストーラー1.12.7)ではクラッシュは見られなかったので、原因はObsidian 1.14.4が付属するElectronとV8のビルドにあると考えています。プラグイン側からはまだ回避策が見つかりません。Obsidianのフォーラムで報告し、こちらの#597と#609で追跡しています。

あなたのObsidianボールトは、モデルコンテキストプロトコルを通じてAIクライアントに公開されます。MCPサーバーはObsidian内部で動作し、ループバックで動作し、ダウンロード用のバイナリやクラウド往復はありません。Claude Desktop、Claude Code、Cursor、Cline、Continue、Windsurf、VS Codeはすべて同じエンドポイントに接続されています。

3.0.0の新要素 ·クイックスタート ·ツール ·レンダリング検索結果 ·適応型ツールの読み込み ·クライアントごとのトークン ·プロンプト ·プロトコル ·クライアント ·トラブルシューティング ·セキュリティ ·開発者向け


仕組み

クライアントの設定は127.0.0.1:27200の共有ブローカーを指しています。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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.

GitHub で README 全文を見る

インストール

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"] } } }