Obsidian MCP Server

Obsidian MCP Server

Obsidian MCP Serverは、Obsidianノートアプリと言語モデル、AIエージェントをModel Context Protocol（MCP）を通して接続する統合レイヤーです。これにより、ローカルボールト内で強力な自動化、知識検索、ノート管理のワークフローが実現します。

Author: MarkusPfundstein


プロトコルを表示

Obsidian MCP Serverとは？

Obsidian MCP Serverは軽量サーバーで、ローカルのObsidianボールトとそのデータを大規模な言語モデルやAIツールに標準化されたMCPインターフェイスを通じて接続します。Obsidian Local REST APIプラグインを利用して、ファイルやディレクトリ、ノート内容と安全にやり取りします。これにより、高度なAIワークフローがノートの検索、取得、編集、管理を簡単に行えます。

Obsidian MCP Serverの設定方法

  1. Obsidian Local REST APIプラグインをインストール
    コミュニティプラグインをダウンロードし、Obsidian内で有効にします。その後、設定パネルからAPIキーをコピーします。
  2. MCPサーバー環境を設定
    a. 望ましい方法: サーバー設定を編集して環境変数を含めます: 
    {
  "mcp-obsidian": {
    "command": "uvx",
    "args": ["mcp-obsidian"],
    "env": {
      "OBSIDIAN_API_KEY": "<your_api_key_here>",
      "OBSIDIAN_HOST": "<your_obsidian_host>"
    }
  }
}
    b. あるいは、次の内容の .env ファイルを作成します: 
    OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host
  3. AI環境と統合
    LLMまたはエージェントホスト（例: Claude Desktop）にObsidian MCP Serverの設定を追加します。これにより、実行中のサーバーに接続できます。

Obsidian MCP Serverの使い方

  • アクセス資格情報を設定した後、Obsidian MCP Serverを起動します。
  • LLM環境で自然言語の指示を使ってデータやアクションをリクエストします。例えば:
    • "最後の会議ノートを要約して、新しい要約ノートを作成してください。"
    • "Azure CosmosDbについてのファイルを検索してください。"
    • "ファイルの内容を取得して、イントロダクションを追加してください。"
  • LLMは、要求された操作を実行するためにObsidianサーバーが提供するツールを自動的に発見し呼び出します。
  • 上級者は、プログラム的に特定のツールを直接呼び出すこともできます。たとえば、ファイルをリスト表示したり、ノート内容を編集したりできます。

主な機能

  • LLMやAIエージェントからObsidianボールト全体とシームレスにやり取り
  • 検索、読み取り、編集、作成、削除を含む豊富なファイルと内容操作機能
  • APIキー認証によるローカルデータへの安全で構成可能な接続
  • Claude Desktopや他のMCP対応AIホストとの柔軟な統合
  • 拡張可能: ワークフローに合わせてツールを追加したり、既存のツールをカスタマイズしたりできます。

使用例

  • 会議ノートの要約と構造化されたフォローアップノートの自動化
  • 迅速な参照のためにノートや知識スニペットを素早く検索・取得
  • 既存のノートに要約や序文、AI生成コンテンツを自動生成して追加
  • LLMを使用して大規模ボールトをプログラム的に管理・整理
  • 日次ノート作成、ナレッジベースの整備、チームドキュメントの更新などの高度なワークフローをスクリプト化。

よくある質問

Q1: Obsidian MCP Serverを使うためにボールト全体をインターネットに公開する必要がありますか？
いいえ、サーバーはローカルREST APIを通じてObsidianのローカルインスタンスに安全に接続します。リモートサービスに明示的に接続しない限り、ボールトはデバイス上に残ります。

Q2: LLMと一緒にObsidian MCP Serverを使用する際、私のデータは安全ですか？
ノートはローカル（または指定したネットワーク内）でのみアクセス可能で、Obsidian APIキーによって保護されています。安全なデプロイメントのために、常にアクセス資格情報とサーバー設定を確認してください。

Q3: Claude以外の他の言語モデルやツールでObsidian MCP Serverを使用できますか？
はい。MCPをサポートする任意のLLMまたはエージェントプラットフォームがObsidian MCP Serverに接続して利用できます。

Q4: もっとアクションを追加したり、機能をカスタマイズしたい場合は？
サーバーは拡張可能です。ソースコードを使って、開発者がカスタムツールを追加したり、既存のものを変更してさらに統合を調整できます。

Q5: これは既存のObsidianプラグインやワークフローと互換性がありますか？
はい、Obsidian MCP Serverは追加のレイヤーとして機能し、標準のREST APIを通じてノートにアクセスします。既存のプラグインやノート構造と互換性があります。