MCP Obsidian

🚀 MCP Obsidian

Obsidianボールトの統合を目的としたModel Context Protocolのサーバーサイドです。このツールはClaude Desktop（または他のMCPクライアント）があなたのObsidianノートを検索および閲覧できるようにします。

🚀 クイックスタート

前提条件

• Node.js 18+（brew install nodeでインストール）
• Obsidianボールト
• Claude Desktop（https://claude.ai/desktop からダウンロードしてインストール）

設定手順

1. Claude Desktopの設定ファイルを開きます。パスは以下の通りです： ~/Library/Application Support/Claude/claude_desktop_config.json

このファイルは以下の手順で見つけることができます：

1. Claude Desktopを開く

2. メニューバーの「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ボールトのパスに置き換えてください。

📚 開発者ガイド

前提条件

• Node.js 18+（brew install nodeでインストール）
• Obsidianボールト
• 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
# またはpnpmを使用する場合
pnpm add -g tsx

3. Claude Desktopの設定ファイルを編集します。パスは以下の通りです： ~/Library/Application Support/Claude/claude_desktop_config.json

このファイルは以下の手順で見つけることができます：

1. Claude Desktopを開く
2. メニューバーの「Claude」をクリック
3. 「設定」を選択
4. 「開発者」を再度クリック

設定ファイルに以下の内容を追加します：

{
  "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：指定されたパスに新しいノートを作成します。