obsidian-mcp

あらゆるObsidianボールトをAIが照会可能なナレッジグラフに変換するMCPサーバー。

既存の24以上のObsidian MCPサーバーとの違い:

• グラフ優先 — [[wikilinks]] によるBFS、最短経路、連結成分、橋の検出

• インフラ不要 — データベース不要、Obsidianの実行不要、APIキー不要

• ボールト非依存 — 既存のボールトならどれでも動作、必須の構造なし

• バックリンク対応の書き込み — move_note がボールト全体のすべての参照を自動更新

• 軽量 — ランタイム依存関係4つ、バンドル~42KB

クイックスタート

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

Related MCP server: some-vault-some-mcp

ツール (12)

読み取り & 探索

グラフ探索

書き込み & 操作

設定

デフォルトで設定不要。ボールトルートに任意の .obsidian-mcp.json:

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

CLIフラグ

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

仕組み

1. 起動時にすべての .md ファイルをスキャンし、インメモリグラフを構築する (1kノートで~1〜3秒)

2. ファイルウォッチャーが変更を検出し、グラフを増分更新する (変更ごとに~5ms)

3. Claude はMCPツールを介してグラフを照会する — 再スキャン不要

4. 書き込み操作はファイルシステムとグラフの両方を原子的に更新する

ハードコードされた除外対象: .obsidian/、.trash/、node_modules/

開発

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

ライセンス

MIT