MCP Obsidian Advanced

🚀 高度なObsidian MCPサーバー

ローカルREST APIコミュニティプラグインを介してObsidianとやり取りするための高度なMCPサーバーです。このサーバーは、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