Smart Connections MCP

🚀 智能連接MCP服務器

這是一個以安全為首要考量的智能連接MCP服務器，具備只讀、路徑驗證和可審計等特性，能夠將 智能連接 的嵌入向量暴露給Claude Code和其他 MCP 客戶端，以實現對Obsidian知識庫的語義搜索。

🚀 快速開始

本項目旨在為Claude Code提供對Obsidian知識庫的語義搜索功能。現有的相關方案存在一些問題，例如缺乏路徑驗證、存在不必要的寫訪問以及依賴過於繁重等。而本實現方案具有依賴少、安全可靠、可審計等優點。

✨ 主要特性

• 文本搜索：支持使用純文本進行查詢，而非僅侷限於筆記路徑。
• 語義搜索：利用智能連接的嵌入向量實現語義搜索。
• 本地推理：使用Transformers.js（與智能連接使用相同的模型）進行本地推理。
• 只讀模式：不進行寫操作，不執行shell命令。
• 安全可靠：嚴格的路徑驗證，響應結果有邊界限制。
• 離線使用：無需運行Obsidian即可工作。

🔒 安全模型

📦 安裝指南

前提條件

• Node.js 18及以上版本
• 安裝了 智能連接 插件的Obsidian
• 已構建嵌入向量（在Obsidian中打開知識庫，讓智能連接進行索引）

安裝步驟

git clone https://github.com/gogogadgetbytes/smart-connections-mcp
cd smart-connections-mcp
npm install
npm run build

配置Claude Code

添加到Claude Code配置中：

claude mcp add smart-connections \
  -e VAULT_PATH="/path/to/your/obsidian/vault" \
  -- node /path/to/smart-connections-mcp/dist/index.js

或者手動添加到 ~/.claude.json：

{
  "mcpServers": {
    "smart-connections": {
      "command": "node",
      "args": ["/path/to/smart-connections-mcp/dist/index.js"],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

重啟Claude Code以加載服務器。

💻 使用示例

配置完成後，Claude Code可以使用以下工具：

文本搜索

"Search my vault for notes about backup strategies"
→ 使用 search_by_text 工具

搜索相似筆記

"Find notes similar to Topics/Claude_Code.md"
→ 使用 search_similar 工具

獲取筆記內容

"Show me the content of Topics/Obsidian.md"
→ 使用 get_note 工具

列出已索引的筆記

"What notes are indexed in my vault?"
→ 使用 list_indexed 工具

🛠️ 工具列表

⚙️ 配置說明

⚠️ 侷限性

• 單知識庫：每個MCP服務器實例只能配置一個知識庫。
• 依賴智能連接索引：筆記嵌入向量來自插件，文本查詢在本地進行嵌入處理。
• 無寫訪問：設計上不提供寫訪問，編輯操作請使用Obsidian。
• 首次運行下載模型：約50MB的模型會緩存到 ~/.cache/huggingface/。

🛠️ 開發指南

# 構建項目
npm run build

# 使用MCP檢查器進行測試
npx @modelcontextprotocol/inspector node dist/index.js

🤝 貢獻指南

詳情請參閱 CONTRIBUTING.md。歡迎提交以安全為重點的PR。

🔐 安全問題

若要報告安全漏洞，請發送郵件至 gogogadgetcode@proton.me。請勿公開提出安全相關問題。

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。

🙏 鳴謝

• 智能連接 由Brian Petro開發
• 模型上下文協議 由Anthropic開發