Obsidian 用 MCP ツール

機能|インストール|設定|トラブルシューティング|セキュリティ|開発|サポート

Obsidian向けMCPツールは、Claude DesktopなどのAIアプリケーションがモデルコンテキストプロトコル（MCP）を介してObsidianの保管庫に安全にアクセスし、操作することを可能にします。MCPは、セキュリティとユーザーコントロールを維持しながら、AIアプリケーションが外部データソースやツールとやり取りする方法を標準化するオープンプロトコルです。[^2]

このプラグインは 2 つの部分で構成されています。

1. 保管庫にMCP機能を追加するObsidianプラグイン
2. AIアプリケーションとの通信を処理するローカルMCPサーバー

このプラグインをインストールすると、両方のコンポーネントの設定に役立ちます。MCPサーバーは、VaultとClaude DesktopなどのAIアプリケーション間の安全なブリッジとして機能します。つまり、AIアシスタントはメモの読み取り、テンプレートの実行、セマンティック検索を実行できますが、これはユーザーが許可した場合のみ、サーバーの安全なAPIを介してのみ可能です。サーバーはAIアプリケーションにVaultファイルへの直接アクセスを許可することはありません。[^3]

プライバシーに関する注意: このプラグインで Claude Desktop を使用する場合、Claude との会話はデフォルトでは Anthropic のモデルのトレーニングに使用されません。[^1]

特徴

Claude Desktop などの MCP クライアントに接続すると、このプラグインにより次のことが可能になります。

• 金庫へのアクセス：AIアシスタントが金庫のセキュリティを維持しながらメモを読んだり参照したりできるようにします [^4]
• セマンティック検索: AIアシスタントは、キーワードだけでなく、意味や文脈に基づいて保管庫を検索できます[^5]
• テンプレートの統合: 動的なパラメータとコンテンツ生成を備えたAIインタラクションを通じてObsidianテンプレートを実行します[^6]

すべての機能には、Claude DesktopのようなMCP対応クライアントが必要です。このプラグインは、これらの統合を可能にするサーバーコンポーネントを提供します。このプラグインはObsidianの機能を直接変更するのではなく、AIアプリケーションがVaultを強力に操作できるようにする安全なブリッジを作成します。

前提条件

必須

• Obsidian v1.7.7 以上
• Claude Desktop のインストールと構成
• ローカル REST APIプラグインがインストールされ、API キーで構成されている

推奨

• テンプレート機能を強化するTemplaterプラグイン
• セマンティック検索機能のためのスマート接続プラグイン

インストール

[!Important] このプラグインは、お使いのコンピュータ上でローカルに実行される安全なサーバーコンポーネントを必要とします。サーバーは署名済みの実行ファイルとして配布され、完全なソースコードはpackages/mcp-server/に含まれています。セキュリティ対策とコード署名プロセスの詳細については、 「セキュリティ」セクションをご覧ください。

1. Obsidianのコミュニティプラグインからプラグインをインストールします
2. Obsidianの設定でプラグインを有効にする
3. プラグインの設定を開く
4. 「サーバーのインストール」をクリックして、MCPサーバーをダウンロードして構成します。

インストール ボタンをクリックすると次のようになります。

• お使いのプラットフォームに適したMCPサーバーバイナリをダウンロードしてください
• Claude Desktopをサーバーを使用するように構成する
• 必要な権限とパスを設定する

設置場所

• サーバーバイナリ: {vault}/.obsidian/plugins/obsidian-mcp-tools/bin/
• ログファイル:
  • macOS: ~/ライブラリ/Logs/obsidian-mcp-tools
  • Windows: %APPDATA%\obsidian-mcp-tools\logs
  • Linux: ~/.local/share/obsidian-mcp-tools/logs

構成

プラグイン設定の「サーバーをインストール」ボタンをクリックすると、プラグインは自動的に次の操作を実行します。

1. 適切なMCPサーバーバイナリをダウンロードする
2. ローカルREST APIプラグインのAPIキーを使用する
3. Claude Desktop を MCP サーバーを使用するように構成する
4. 適切なパスと権限を設定する

設定プロセスは自動化されていますが、サーバーバイナリのインストールとClaude Desktopの設定変更には明示的な許可が必要です。この初期設定手順以外では、追加の手動設定は必要ありません。

トラブルシューティング

問題が発生した場合:

1. プラグインの設定を確認して下さい:
   • 必要なプラグインはすべてインストールされています
   • サーバーは適切にインストールされている
   • クロードデスクトップが設定されました
2. ログを確認します。
   • プラグイン設定を開く
   • リソースの下にある「ログを開く」をクリックします
   • エラーメッセージや警告がないか確認する
3. よくある問題:
   • サーバーが起動しません: Claude Desktop が実行中であることを確認してください
   • 接続エラー: ローカルREST APIプラグインが設定されていることを確認してください
   • 権限エラー: サーバーを再インストールしてください

安全

バイナリ配布

• すべてのリリースは、再現可能なビルドを備えたGitHub Actionsを使用して構築されます。
• バイナリはSLSAの起源を使用して署名および証明されます
• リリースワークフローはリポジトリ内で完全に監査可能

ランタイムセキュリティ

• MCPサーバーは最小限の権限で実行されます
• すべての通信は暗号化されています
• APIキーはプラットフォーム固有の認証情報ストレージを使用して安全に保存されます

バイナリ検証

MCPサーバーのバイナリは、 SLSA Provenance認証付きで公開されます。SLSA Provenance認証は、バイナリがどこでどのようにビルドされたかを暗号的に証明するものです。これにより、ダウンロードしたバイナリの整合性と出所が保証されます。

GitHub CLI を使用してバイナリを検証するには:

1. GitHub CLI をインストールします。
   # macOS (Homebrew) brew install gh # Windows (Scoop) scoop install gh # Linux sudo apt install gh # Debian/Ubuntu
2. バイナリを検証します。
   gh attestation verify --owner jacksteamdev <binary path or URL>

検証により次の内容が表示されます:

• バイナリのSHA256ハッシュ
• このリポジトリのGitHub Actionsワークフローによってビルドされたことの確認
• それを作成した特定のワークフローファイルとバージョンタグ
• SLSA レベル 3 ビルド要件への準拠

この検証により、バイナリが改ざんされておらず、このリポジトリのソース コードから直接ビルドされたことが保証されます。

セキュリティ問題の報告

セキュリティ上の脆弱性は、セキュリティポリシーを通じてご報告ください。公開されている問題ではセキュリティ上の脆弱性を報告しないでください。

発達

このプロジェクトは、機能ベースのアーキテクチャを採用したモノレポ構造を採用しています。プロジェクトアーキテクチャに関する詳細なドキュメントについては、 .clinerules をご覧ください。

Clineの使用

このプロジェクトの一部のコードは、AIコーディングエージェントClineを使用して実装されました。Clineは、新機能を実装する際に、 cline_docs/と.clinerulesファイルを使用してプロジェクトのアーキテクチャとパターンを理解します。

ワークスペース

このプロジェクトでは、 Bunワークスペース構造を使用します。

建物

1. 依存関係をインストールします:
   bun install
2. すべてのパッケージをビルドします。
   bun run build
3. 開発の場合:
   bun run dev

要件

• bun v1.1.42以上
• TypeScript 5.0以上

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. テストを実行します:
   bun test
5. プルリクエストを送信する

詳細なガイドラインについては、 CONTRIBUTING.md を参照してください。

サポート

• バグ報告や機能リクエストについては問題を開いてください
• 質問や一般的なヘルプのためのディスカッションを開始する

変更履歴

各リリースの変更点のリストについては、 CHANGELOG.md を参照してください。

ライセンス

MITライセンス

脚注

[^1]: Claude データのプライバシーとセキュリティについては、 Claude AI のデータ使用ポリシーを参照してください。[^2]: モデルコンテキストプロトコルの詳細については、 MCP の概要を参照してください。[^3]: 利用可能な MCP クライアントの一覧については、 MCP サンプルクライアントを参照してください。[^4]: Obsidian プラグインのローカル REST API が必要です。[^5]: Obsidian プラグインのスマート接続が必要です。[^6]: Obsidian プラグインのテンプレートが必要です。