MCP Obsidian Advanced

🚀 Advanced Obsidian MCP Server

Advanced MCPサーバーは、ObsidianのLocal REST APIコミュニティプラグインを介してObsidianとやり取りするためのものです。このサーバーは、AIエージェント（Claudeなど）が、単なる読み書き操作を超えて、ボールトの構造、リンク、コンテンツを深く理解できるようにします。

obsidiantoolsライブラリによって提供される主要な高度な機能は以下の通りです。

• ボールトのツリー構造を探索し、ノートの階層をマッピングする
• ノートの接続関係をNetworkXグラフで分析し、LLMに適した洞察を得る
• AIから直接Obsidianのコマンドを実行する
• メタデータとリンクの詳細を含めて、複数のファイルを一括で読み取る
• リアルタイムのコンテキストを得るために、現在アクティブなノートにアクセスする
• シームレスな編集のために、新しいObsidianのウィンドウでノートやファイルを開く

この設定により、AIエージェントがあなたと協力して、知識ベースを効率的にナビゲートし、強化することで生産性を向上させます。

✨ 主な機能

ツール

サーバーは、Obsidianとやり取りするための複数のツールを実装しています。

コアファイル操作

• obsidian_list_files_in_dir：特定のObsidianディレクトリ内のすべてのファイルとディレクトリをリストする
• obsidian_batch_get_files：ボールト内の1つまたは複数のノート（.mdファイル）の内容とメタデータを返す
• obsidian_put_file：ボールト内に新しいファイルを作成するか、既存のファイルの内容を更新する
• obsidian_append_to_file：ボールト内の新しいまたは既存のファイルに内容を追加する
• obsidian_patch_file：見出し、ブロック参照、またはフロントマターフィールドに関連して、既存のノートに内容を挿入する
• obsidian_delete_file：ボールトからファイルまたはディレクトリを削除する

検索操作

• obsidian_simple_search：ボールト内のすべてのファイルに対して、指定されたテキストクエリに一致するドキュメントを簡単に検索する
• obsidian_complex_search：'glob'と'regexp'のパターンマッチングをサポートするJsonLogicクエリを使用して、ドキュメントを複雑に検索する

ノート管理

• obsidian_get_active_note：Obsidianで現在アクティブなノートの内容とメタデータを取得する
• obsidian_periodic_notes：指定された期間（日次、週次、月次、四半期次、年次）の現在の定期ノートを取得する
• obsidian_recent_periodic_notes：指定された期間タイプの最新の定期ノートを取得する
• obsidian_recent_changes：ボールト内で最近変更されたファイルを取得する
  • 注意：このツールはDataviewコミュニティプラグインが必要です。ボールトにDataviewプラグインをインストールしてください。

ボールト分析

• obsidian_understand_vault：ディレクトリツリーとノートの接続関係のNetworkXグラフを含む、ボールト構造の包括的な理解を得る
• obsidian_open_files：ボールト内の1つまたは複数のファイルを新しいウィンドウで開く
• obsidian_list_commands：Obsidianインターフェイスで実行できるすべての利用可能なコマンドをリストする
• obsidian_execute_commands：Obsidianインターフェイスで1つまたは複数のコマンドを実行する

プロンプトの例

最初にClaude（または他のMCPクライアント）にObsidianを使用するように指示すると良いです。そうすると、常にツールを呼び出します。例えば、

以下のようなプロンプトを使用します。

• "私が現在Obsidianで作業しているレポートのマーケティングセクションを拡充してください"
  • Claudeはobsidian_get_active_noteを使用してノートを読み取り、編集します。
• "Azure CosmosDbが記載されているすべてのファイルを検索し、記載されている文脈を簡単に説明してください"
• "最後の会議ノートを要約し、新しいノート'summary meeting.md'に入れてください。導入文を追加して、メールで送信できるようにしてください。"

📦 インストール

環境変数

このMCPサーバーには、設定が必要な2つの必須環境変数があります。

• OBSIDIAN_API_KEY：Obsidian REST APIプラグインをインストールし、設定にアクセスして取得します。
• OBSIDIAN_VAULT_PATH：ボールトへの絶対パスを設定する必要があります。これにより、ツール（例：obsidian_understand_vault）が正常に機能します。

さらに、変更可能な3つのオプション環境変数があります。

• OBSIDIAN_HOST：Obsidian REST APIプラグインの設定で変更できます。プラグインのデフォルト設定に従い、デフォルトは127.0.0.1です。
• OBSIDIAN_PORT：Obsidian REST APIプラグインの設定で変更できます。プラグインのデフォルト設定に従い、デフォルトは27124です。
• INCLUDE_TOOLS：この変数は、使用可能なツールを制御します。
  • 使用したいツールの名前（上記にリストされている名前）をコンマで区切って記述します。
  • 例えば、obsidian_understand_vaultとobsidian_simple_searchツールのみを使用する場合は、.envまたはサーバー設定でINCLUDE_TOOLS="obsidian_understand_vault,obsidian_simple_search"と設定します。

Obsidian REST APIキーを使用して環境を構成する方法は2つあります。

1. サーバー設定に追加する（推奨）：

{
  "mcp-obsidian-advanced": {
    "command": "uvx",
    "args": [
      "mcp-obsidian-advanced"
    ],
    "env": {
      "OBSIDIAN_API_KEY": "%3Cyour_api_key_here%3E",
      "OBSIDIAN_HOST": "<your_obsidian_host>",
      "OBSIDIAN_PORT": "<your_obsidian_port>",
      "OBSIDIAN_VAULT_PATH": "</path/to/your/vault>",
      "INCLUDE_TOOLS": ""
    }
  }
}

時々、Claudeがuv / uvxの場所を検出できない問題があります。その場合は、which uvxを使用して完全なパスを見つけ、上記の設定に貼り付けてください。

2. 作業ディレクトリに.envファイルを作成し、以下の変数を設定する（OBSIDIAN_API_KEYとOBSIDIAN_VAULT_PATHのみ必須）：

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host
OBSIDIAN_PORT=your_obsidian_port
OBSIDIAN_VAULT_PATH=/path/to/your/vault
INCLUDE_TOOLS=name_of_tool1,name_of_tool2,...

注意：APIキー、ホスト、ポートはObsidianプラグインの設定で確認できます。指定されていない場合、デフォルトのポートは27124、デフォルトのホストは127.0.0.1です。

🚀 クイックスタート

インストール

Obsidian REST API

Obsidian REST APIコミュニティプラグインを実行する必要があります：https://github.com/coddingtonbear/obsidian-local-rest-api

• Obsidianの「コミュニティプラグイン」にアクセスし、検索してインストールできます。

設定でインストールして有効にし、APIキーをコピーします。

Claude Desktop

MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

公開サーバーの設定：

{
  "mcpServers": {
    "mcp-obsidian-advanced": {
      "command": "uvx",
      "args": [
        "mcp-obsidian-advanced"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<your_api_key_here>",
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault/"
      }
    }
  }
}

開発/非公開サーバーの設定：

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "/dir/to/mcp-obsidian-advanced",
        "run",
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<your_api_key_here>",
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault/"
      }
    }
  }
}

📚 ドキュメント

obsidiantoolsライブラリとObsidian REST APIの追加ドキュメント

obsidiantoolsライブラリとObsidian REST APIの追加ドキュメントは、docsディレクトリにあります。

• obsidiantools_in_15_minutes_documentation.mdは、obsidiantoolsの使用例を示すipynbファイルです。
• obsidian_rest_api_documentation.yamlは、Obsidian REST APIの使用例を示すyamlファイルです。

ビルド

パッケージを配布用に準備するには：

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

デバッグ

MCPサーバーはstdioを介して実行されるため、デバッグは難しい場合があります。最良のデバッグ体験を得るために、MCP Inspectorの使用を強くお勧めします。

以下のコマンドを使用して、npm経由でMCP Inspectorを起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-obsidian-advanced run mcp-obsidian-advanced

起動すると、Inspectorはブラウザでアクセスしてデバッグを開始できるURLを表示します。

以下のコマンドでサーバーログを監視することもできます。

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-obsidian-advanced.log