MCP Obsidian

🚀 ObsidianのMCPサーバ

MCPサーバは、ObsidianのコミュニティプラグインであるLocal REST APIを通じて、Obsidianとのインタラクションを可能にします。

🚀 クイックスタート

📦 インストール

Obsidian REST API

実行に必要なObsidian REST APIコミュニティプラグインをインストールして有効にします：https://github.com/coddingtonbear/obsidian-local-rest-api

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

Claude Desktop

• MacOS：~/Library/Application\ 支持/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-obsidian",
        "run",
        "mcp-obsidian"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY" : "<YOUR_OBSIDIAN_API_KEY>"
      }
    }
  }
}

✨ 主な機能

🔧 ツール

このサーバは、Obsidianとのインタラクションのために複数のツールを実装しています：

• list_files_in_vault：vaultのルートディレクトリ内のすべてのファイルとディレクトリをリストする
• list_files_in_dir：特定のObsidianディレクトリ内のすべてのファイルとディレクトリをリストする
• get_file_contents：vault内の単一ファイルの内容を返す
• search：vault内のすべてのファイルから、指定されたテキストクエリに一致するドキュメントを検索する
• patch_content：タイトル、ブロック引用、またはフロントエンドフィールドに対して、既存のノートに内容を挿入する
• append_content：新しいファイルまたは既存のファイルに内容を追加する
• delete_file：vaultからファイルまたはディレクトリを削除する

💡 サンプルプロンプト

まずClaudeにObsidianを使用するよう指示し、その後は常にツールを呼び出します。

以下のプロンプトを使用します：

• 前回のアーキテクチャ通話のノートの内容を取得し、要約する
• Azure CosmosDbが記載されているすべてのファイルを検索し、そのコンテキストを簡単に説明する
• 前回の会議の議事録を要約し、新しいノート'summary meeting.md'にまとめる。電子メールで送信できるように紹介文を追加する

🔧 技術詳細

⚙️ 設定

Obsidian REST APIキー

Obsidian REST APIキーを使用するための環境設定には2つの方法があります。

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

{
  "mcp-obsidian": {
    "command": "uvx",
    "args": [
      "mcp-obsidian"
    ],
    "env": {
      "OBSIDIAN_API_KEY": "<your_api_key_here>",
      "OBSIDIAN_HOST": "<your_obsidian_host>"
    }
  }
}

2. 作業ディレクトリに .env ファイルを作成し、以下の必要な変数を含めます：

OBSIDIAN_API_KEY=your_api_key_here
OBSIDIAN_HOST=your_obsidian_host

⚠️ 重要提示

キーはObsidianプラグインの設定で見つけることができます。

🔨 ビルド

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

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

uv sync

🐞 デバッグ

MCPサーバはstdioを介して実行されるため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCPインスペクターの使用を強くおすすめします。

以下のコマンドでMCPインスペクターを起動できます：

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

起動後、インスペクターはURLを表示し、ブラウザでアクセスしてデバッグを開始できます。

以下のコマンドでサーバログを表示することもできます：

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