coddingtonbear/obsidian-local-rest-api

解決する課題

このプロジェクトは、Obsidian向けの安全で認証されたREST APIおよびMCP (Model Context Protocol) サーバーを提供します。これにより、外部スクリプト、ブラウザ拡張機能、AIエージェントがプログラムからObsidian Vaultと対話できるようになります。

仕組み

ローカルサーバーをホストするObsidianプラグインとして動作します。標準的なHTTPリクエスト用のREST APIと、AIエージェント用の組み込みMCPサーバーを公開します。両方のインターフェースは同じコア機能を提供しており、Vaultファイルに対する完全なCRUD操作、特定のノートセクション（見出し、ブロック、またはfrontmatter）の外科的パッチ適用、Obsidianコマンドの実行、および全文検索や構造化されたJsonLogicクエリを使用したVaultの検索が可能です。

対象ユーザー

• 開発者: Obsidian Vault管理を自動化するためのスクリプトやブラウザ拡張機能を作成する方。
• AIエージェントユーザー: LLMベースのツール（Claude Code、Claude Desktop、Cursorなど）を個人のナレッジベースに直接接続したい方。

主な特徴

• 外科的パッチ適用 (Surgical Patching): ファイル全体を書き換えることなく、ノートの特定のセクションを編集（追加、先頭への挿入、置換、削除）できます。
• MCP統合: Model Context Protocolをネイティブサポートしており、AIエージェントがVaultの読み書きを行えます。
• Vaultイベント: Server-Sent Eventsストリームを通じて、Vaultの変更（ノート作成、frontmatterの変更など）を購読できます。
• 安全なアクセス: すべてのリクエストは、ローカルで生成された証明書とAPIキー認証を使用してHTTPS経由で提供されます。
• 拡張可能なAPI: 他のプラグインは、拡張インターフェースを介して独自のカスタムルートを登録できます。