MCP オブシディアン

Obsidian Vault 統合用のモデルコンテキストプロトコルサーバー。これにより、Claude Desktop（または任意の MCP クライアント）で Obsidian ノートを検索および閲覧できるようになります。

クイックスタート（ユーザー向け）

前提条件

• Node.js 18+ ( brew install nodeでインストール)

• 黒曜石の金庫

• Claude Desktop ( https://claude.ai/desktopからインストール)

構成

1. Claude Desktop 構成ファイルを開きます: ~/Library/Application Support/Claude/claude_desktop_config.json

これは、Claude デスクトップ メニューから見つけることができます。

1. クロードデスクトップを開く

2. MacのメニューバーでClaudeをクリック

3. 「設定」をクリック

4. 「開発者」をクリック

5. 設定に以下を追加します。

{
  "tools": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

注: /path/to/your/obsidian/vault実際の Obsidian vault パスに置き換えます。

Related MCP server: MCP Tools for Obsidian

開発者向け

前提条件

• Node.js 18+ ( brew install nodeでインストール)

• 黒曜石の金庫

• Claude Desktop ( https://claude.ai/desktopからインストール)

• tsx ( npm install -g tsxでインストール)

インストール

git clone https://github.com/kazuph/mcp-obsidian.git
cd mcp-obsidian
npm install
npm run build

構成

1. Claude Desktop がインストールされ、実行されていることを確認してください。

2. まだインストールしていない場合は、tsx をグローバルにインストールします。

npm install -g tsx
# or
pnpm add -g tsx

3. Claude Desktop の設定を変更してください: ~/Library/Application Support/Claude/claude_desktop_config.json

これは、Claude Desktop メニューから簡単に見つけることができます。

1. クロードデスクトップを開く

2. MacのメニューバーでClaudeをクリック

3. 「設定」をクリック

4. 「開発者」をクリック

MCP クライアントの構成に以下を追加します。

{
  "tools": {
    "obsidian": {
      "args": ["tsx", "/path/to/mcp-obsidian/index.ts"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

利用可能なツール

• obsidian_read_notes : 複数のノートの内容を読み取ります。各ノートの内容は、パスを参照として返されます。

• obsidian_search_notes : 名前でノートを検索します (大文字と小文字を区別せず、部分一致と正規表現をサポートします)。

• obsidian_read_notes_dir : 指定されたパスの下のディレクトリ構造を一覧表示します。

• obsidian_write_note : 指定されたパスに新しいノートを作成します。