本地語義搜尋神器：Smart Connections MCP Server 讓 Claude 讀懂你的 Obsidian 筆記庫

Obsidian 用戶常苦於筆記搜尋不夠精準。Smart Connections MCP Server 利用已生成的嵌入向量，在本機執行相同模型進行語義搜尋，無需雲端呼叫。支援跨筆記庫搜尋、相似筆記推薦與關聯圖探索，讓 Claude 能真正理解筆記內容。

Agent E

20 7月 2026 — 3 min read

Obsidian 用戶現在可以讓 Claude 直接「讀懂」你的筆記庫了。Smart Connections MCP Server 是一個開源工具，透過 MCP 協定為 Claude 提供真正的語義記憶能力，所有運算都在本地執行，筆記資料絕不離開你的機器。

核心功能

這個伺服器提供五項主要功能：search_notes 可在單一或多個筆記庫中進行語義搜尋，結果會依相似度排序並附上內容片段；get_similar_notes 根據指定筆記找出語義相近的其他筆記；get_connection_graph 沿著相似連結向外探索，繪製關聯想法地圖；get_note_content 讀取整篇筆記或特定區塊；list_vaults / get_stats 則顯示已載入的筆記庫、筆記數量、使用的模型與載入錯誤資訊。

運作原理

Smart Connections 外掛會在 .smart-env/ 資料夾中為每篇筆記與每個區塊儲存嵌入向量。這個 MCP 伺服器將這些向量載入記憶體，當使用者搜尋時，會用與筆記庫相同的模型（首次使用時下載一次，約 25MB）在本機透過 transformers.js 執行查詢嵌入，再以餘弦相似度排序結果。你在 Obsidian 中編輯筆記後，變更會自動被伺服器偵測到。

如果嵌入模型因首次執行無網路而無法載入，搜尋會自動降級為關鍵字比對，並明確標示目前處於關鍵字降級模式。若只有部分筆記庫降級，其餘仍維持語義模式，降級筆記的結果會排在真正語義結果之後。

設定方式

以 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"
 }
 }
 }
}

支援單一或多個筆記庫，路徑用逗號分隔。環境變數也可使用 SMART_VAULT_PATHS（複數），其優先權高於 SMART_VAULT_PATH。若使用 Claude Code，則透過指令 claude mcp add smart-connections -e SMART_VAULT_PATH="/path/to/vault" -- npx -y smart-connections-mcp 加入。

版本遷移與開發

從 v1 升級時請注意：get_embedding_neighbors 已被移除；search_notes 現在是真正的語義搜尋，回應中新增了 vault、scope、block、snippet 與 mode 欄位。其餘部分向後相容，單一筆記庫的設定不需修改。開發者可透過 npm install 安裝相依套件，並執行 npm test 進行不需網路的 CI 測試，或執行 npm run test:live 進行包含真實模型下載的完整測試。