Obsidian MCP Server

obsidian-mcp-serverは、Obsidian VaultのMarkdownドキュメントをAIエージェントが閲覧、検索、要約できるようにするMCPサーバーです。

MCPクライアントに接続することで、エージェントがトークン使用量を制御しながらVaultの内容を閲覧できるようにします。

できること

• キーワードベースのノート検索 (vault, action="search")

• 特定のノートの閲覧 (vault, action="read")

• Vault内の全ドキュメントリストの取得 (vault, action="list_all")

• Vaultの状態確認 (vault, action="stats")

• 長期コンテキスト用メモリパケットの生成 (vault, action="collect_context")

• 保存されたメモリノートの読み込み (vault, action="load_memory")

• フロントマター自動生成の提案 (generate_property)

• フロントマターの実際の反映 (write_property)

• ドキュメントベースのプロンプトワークフロー (create_document_with_properties)

• 画像添付ファイルの整理 (organize_attachments)

事前注意点

このサーバーはVaultの内容をクライアントに公開します。運用環境では慎重に使用してください。

• 信頼できないAIエージェントには接続しないでください。

• Vaultパス(VAULT_DIR_PATH)は最小権限に制限してください。

• 閲覧量が多いVaultでは、maxOutputCharsやlimitを調整してトークンコストを制御してください。

• vaultアクションのデフォルト圧縮モードはbalancedです。

設定確認事項

1. Vaultパス: VAULT_DIR_PATHには必ず絶対パスを入力する必要があります。

// ✅ 올바른 예시
"VAULT_DIR_PATH": "/Users/username/Documents/MyVault"
"VAULT_DIR_PATH": "C:\\Users\\username\\Documents\\MyVault"  // Windows
"VAULT_DIR_PATH": "/mnt/c/Users/username/Documents/MyVault"  // WSL

// ❌ 잘못된 예시
"VAULT_DIR_PATH": "~/Documents/MyVault"  // 상대 경로 사용 불가
"VAULT_DIR_PATH": "./vault"              // 상대 경로 사용 불가

2. Node.js要件: Node.js 22以上がインストールされている必要があります。

node --version  # v22.0.0 이상 확인

はじめに（クイックセットアップ）

1) 共通要件

• 最小設定はVAULT_DIR_PATH（Vaultの絶対パス）です。

• MCPの実行自体は配布パッケージを基準に説明します。

  • 配布パッケージ(npx)の使用（推奨）

  • ローカルのbuild/index.jsは開発/デ