Smart Connections MCP Server

**Claude に Obsidian ボールトの真のセマンティックメモリを与えます。**ノートを 意味 で検索する MCP サーバー。Smart Connections Obsidian プラグインがすでに生成した埋め込みを再利用し、クエリを理解するために同じ埋め込みモデルをローカルで実行します。クラウド呼び出しなし。ボールトがマシンの外に出ることはありません。

機能

• search_notes — 1つまたは複数のボールトを横断したセマンティック検索。ノート全体 と 個々のセクション（ブロック）をマッチングし、コンテンツスニペット付きの類似度順の結果を返します。

• get_similar_notes — 指定されたノートに類似したノート（保存済みの埋め込みを使用）。

• get_connection_graph — 類似リンクを外側に向かってたどり、関連するアイデアをマッピングします。

• get_note_content — ノートを読み込む、または特定のブロックを抽出します。

• list_vaults / get_stats — 読み込み済みの内容、件数、モデル、読み込みエラー。

Related MCP server: ob-smart-connections-mcp

要件

• Node.js 20+

• Smart Connections プラグインがインストールされ、埋め込みが生成済みの Obsidian ボールト（v2 は Smart Connections 3.x のデータでテスト済み）

• MCP クライアント（Claude Desktop、Claude Code、…）

セットアップ（Claude Desktop）

claude_desktop_config.json に追加して Claude Desktop を再起動します：

{
  "mcpServers": {
    "smart-connections": {
      "command": "npx",
      "args": ["-y", "smart-connections-mcp"],
      "env": {
        "SMART_VAULT_PATH": "/path/to/Vault One,/path/to/Vault Two"
      }
    }
  }
}

ボールトが1つでも複数でもかまいません。パスはカンマで区切ります。

SMART_VAULT_PATHS（複数形）も SMART_VAULT_PATH の別名として受け付けられ、両方が設定されている場合は SMART_VAULT_PATHS が優先されます。

Claude Code

claude mcp add smart-connections -e SMART_VAULT_PATH="/path/to/vault" -- npx -y smart-connections-mcp

仕組み

Smart Connections はすべてのノートとブロックの埋め込みベクトルを .smart-env/ に保存します。このサーバーはそれらのベクトルをメモリに読み込み、検索時にボールトが使用した 同じモデル でクエリを埋め込みます（一度ダウンロード、~25MB、transformers.js 経由でローカル実行）。結果はコサイン類似度でランク付けされます。Obsidian で行った編集は自動的に反映されます。

埋め込みモデルを読み込めない場合（例：初回実行時にネットワークがない場合）、またはボールトにまだ埋め込みがない場合、検索はリテラルなキーワードマッチングにフォールバックし、その旨を明示します（"mode": "keyword-fallback" と原因を示す warning）。一部のボールトだけがフォールバックする場合、mode は "semantic" のままで、該当行には "match": "keyword" が付き、常に真のセマンティック行より後ろにランク付けされます。

v1 からの移行

• get_embedding_neighbors は削除されました。

• search_notes は現在真のセマンティック検索となり、レスポンスに vault、scope、block、snippet、mode フィールドが含まれます。

• その他はすべて後方互換です。単一ボールトの SMART_VAULT_PATH 設定は変更なしで動作します。

開発

npm install
npm test              # build + CI-tier tests (no network)
npm run test:live     # + real-model tests (downloads ~25MB once)
npm run smoke -- "/path/to/vault" "your query"

MIT — LICENSE を参照。