Obsidian MCP

Obsidian MCP（Model Context Protocol）サーバー

English | 中文

このプロジェクトは、AI モデルを Obsidian のナレッジベースに接続するための Model Context Protocol（MCP）サーバーを実装しています。このサーバーを通じて、AI モデルは Obsidian のノートに直接アクセスして操作できます。ノートの読み取り、作成、更新、削除のほか、フォルダー構造の管理も可能です。

作成者：huangyihe

• Prompt House：https://prompthouse.app/
• YouTube：https://www.youtube.com/@huanyihe777
• Twitter：https://x.com/huangyihe
• コミュニティ：https://t.zsxq.com/19IaNz5wK

機能

• 🔗 Obsidian とのシームレスな連携：MCP プロトコルを通じて Obsidian のナレッジベースに直接アクセス
• 📝 ノートの総合管理：高度なテキスト置換を使って、ノートの読み取り、作成、更新、削除が可能
• 📁 フォルダー操作：完全な階層構造をサポートし、フォルダーの作成、名前変更、移動、削除が可能
• 🔍 インテリジェント検索：スマートなスコアリングにより、あらゆるファイル形式を全文検索
• 🤖 AI を活用した分析：新機能 TRILEMMA-PRINCIPLES フレームワークを使った戦略的な分析
• 🔗 バックリンクの自動生成：新機能 ノート名をインテリジェントに検出し、ウィキリンクに変換
• ⚡ 高精度な編集：見出しやブロック単位で対象を指定できる、高度な PATCH 操作
• 🚀 2 つの API による戦略：信頼性を最大限に高める、Obsidian REST API とファイルシステムのフォールバック
• 🎯 コンテキストの最適化：LLM のコンテキスト長を管理するためのスマートなコンテンツ要約
• 📊 バッチ処理：進行状況の追跡機能を備えた効率的な一括操作

サポート対象のツール

MCP サーバーは、次の包括的なツールを提供します。

📋 コア操作

• list_notes：Obsidian の保管庫内のノートを一覧表示します。フォルダーによる絞り込みは任意です
  • 新機能 recursive パラメーター：サブディレクトリ内のファイルも再帰的に一覧表示するかどうかを指定します（既定値：true）
  • recursive: false を指定すると、サブディレクトリを含めず、指定したフォルダー内のファイルのみを一覧表示します
• read_note：Obsidian の保管庫内にある特定のノートの内容を読み取ります
• read_multiple_notes：複数のノートの内容を同時に読み取り、バッチ処理します
• create_note：内容を指定して、Obsidian の保管庫に新しいノートを作成します
• delete_note：Obsidian の保管庫からノートを削除します
• search_vault：ファイル名と内容に一致する、あらゆるファイル形式を対象とした高度な検索を実行します
• move_note：ノートを新しい場所に移動または名前変更します（PDF を含むすべてのファイル形式に対応）
• manage_folder：フォルダーに対する CRUD 操作を一通り実行します（作成／名前変更／移動／削除）

🚀 高度な機能

• update_note：強化機能 テキスト置換または高精度な挿入を使って内容を更新します

  • 従来のテキスト置換モード
  • 新機能 見出しを基準にした挿入（前／後／末尾に追加／先頭に追加）
  • 新機能 ^block-id に対応したブロック ID 基準の挿入
  • 新機能 ファイルシステムへのフォールバックを備えた PATCH API 連携

• auto_backlink_vault：🔗 バックリンクの自動生成

  • 保管庫全体をスキャンし、ノート名への言及を検出
  • テキスト内の参照をウィキリンク形式（[[note name]]）に変換
  • 誤検出を防ぐスマートなパターンマッチング
  • ドライランモードとバッチ処理を設定可能

• notes_insight：🧠 AI を活用した戦略分析 ⭐ 新機能

  • TRILEMMA-PRINCIPLES フレームワークを使って、戦略的な分析を生成
  • トピックに基づいてノートを自動的に検出し、関連性を順位付け
  • AI によるコンテンツ要約でコンテキストを最適化
  • 構造化された分析：制約の特定 → 前提への疑問の提示 → 突破口となる解決策
  • 分析の深さと範囲を調整するパラメーターを設定可能

前提条件

• Node.js（v16 以降）
• Obsidian デスクトップアプリケーション
• Obsidian Local REST API プラグイン（Obsidian にインストールする必要があります）

インストール方法

技術レベルと利用ニーズに合わせて、最適なインストール方法を選択してください。

方法	対象ユーザー	メリット	デメリット
🎯 ワンクリックインストール（DXT）	一般ユーザー	最も簡単で、GUI で設定可能	DXT 対応クライアントが必要
📦 リモートインストール（NPM）	Node.js ユーザー	自動更新、インストール不要	ネットワーク接続が必要
🔧 ローカルデプロイ	上級ユーザー	オフラインで利用可能、完全な制御	手動での更新が必要

---

方法 1：ワンクリックインストール（DXT パッケージ） - ✅ 推奨

対象： 最も簡単なインストール方法を希望する一般ユーザー

ステップ 1：DXT ファイルをダウンロード

ビルド済みの拡張機能パッケージをダウンロードします：obsidian-mcp.dxt

ステップ 2：インストールと設定

ダウンロードした .dxt ファイルをダブルクリックすると、システムが拡張機能を自動的にインストールします。次に、設定画面に入力します。

• Vault Path：Obsidian の保管庫のパス（例：/Users/username/Documents/MyVault）
• API Token：Obsidian Local REST API プラグインのトークン
• API Port：API ポート番号（デフォルト：27123）

---

方法 2：リモートインストール（NPM パッケージ）

対象： 自動更新とバージョン管理を希望する Node.js 開発者

MCP クライアントの設定ファイルに、以下の設定を追加するだけです。

npx を使用する場合（推奨、事前インストール不要）：

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "@huangyihe/obsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        "OBSIDIAN_API_TOKEN": "your_api_token",
        "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}

注： 初回実行時にパッケージが自動的にダウンロードされます。2 回目以降はキャッシュが使用されるため、常に最新バージョンを利用できます。

---

方法 3：ローカルデプロイ

対象： カスタマイズ、高度な制御、またはオフラインでの利用が必要なユーザー

オプション A：グローバルインストール（推奨）

ステップ 1：グローバルインストール

npm install -g @huangyihe/obsidian-mcp

ステップ 2：MCP クライアントの設定

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "obsidian-mcp",
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault",
        "OBSIDIAN_API_TOKEN": "your_api_token",
        "OBSIDIAN_API_PORT": "27123"
      }
    }
  }
}

オプション B：ソースからデプロイ

ステップ 1：リポジトリをクローン

git clone https://github.com/newtype-01/obsidian-mcp.git
cd obsidian-mcp

ステップ 2：依存関係をインストール

npm install

ステップ 3：プロジェクトをビルド

npm run build

ステップ 4：環境変数を設定

cp .env.example .env
# Edit .env file with your configuration

ステップ 5：サーバーを起動

npm start

オプション C：Docker でデプロイ

Docker Compose を使用（推奨）

# Configure environment variables
cp .env.example .env
# Edit .env file

# Start service
docker-compose up -d

Docker コマンドを使用

# Build image
docker build -t obsidian-mcp .

# Run container
docker run -d \
  --name obsidian-mcp \
  --env-file .env \
  --network host \
  -v $(OBSIDIAN_VAULT_PATH):$(OBSIDIAN_VAULT_PATH) \
  obsidian-mcp

---

設定ガイド

環境変数

すべてのインストール方法で、以下の設定が必要です。

• OBSIDIAN_VAULT_PATH：Obsidian の保管庫のパス
• OBSIDIAN_API_TOKEN：Obsidian Local REST API プラグインの API トークン
• OBSIDIAN_API_PORT：Obsidian Local REST API の API ポート（デフォルト：27123）

⚠️ 重要： リモート NPM インストールとグローバルインストールでは、環境変数に必ず OBSIDIAN_ プレフィックスを使用してください。プレフィックスのない VAULT_PATH および API_TOKEN は正しく動作しません。

API トークンの取得

1. Obsidian に「Local REST API」プラグインをインストールします
2. プラグインの設定で API トークンを生成します
3. ポート番号を確認します（デフォルトは 27123 です）

テスト

このプロジェクトには、サーバーの機能を確認するためのテストスクリプトが含まれています。

node test-mcp.js

開発

• npm run dev を使用して、開発モードでサーバーを実行します
• ソースコードは src ディレクトリにあります

ライセンス

MIT

コントリビューション

プルリクエストやイシューを歓迎します！

関連プロジェクト

• Model Context Protocol
• Obsidian Local REST API