smart-connections-mcp

Smart Connections MCP サーバー

Claude に Obsidian の保管庫に関する真のセマンティックメモリを提供します。 ノートを 意味 に基づいて検索する MCP サーバーです。Smart Connections Obsidian プラグインがすでに生成した埋め込みを再利用し、同じ埋め込みモデルをローカルで実行してクエリを理解します。クラウドへの通信はなく、保管庫がデバイスの外に出ることはありません。

できること

• search_notes — 1 つ以上の保管庫を対象にしたセマンティック検索です。ノート全体 と 個々のセクション（ブロック）を検索し、類似度順にコンテンツの抜粋を返します。
• get_similar_notes — 指定したノートに類似するノートを返します（保存済みの埋め込みを使用）。
• get_connection_graph — 類似度リンクをたどり、関連するアイデアのつながりをマッピングします。
• get_note_content — ノートを読み込むか、特定のブロックを抽出します。
• list_vaults / get_stats — 読み込まれている保管庫、件数、モデル、読み込みエラーを確認できます。

要件

• 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 を参照してください。