smart-connections-mcp

Name: smart-connections-mcp
Author: msdanyg

本地服务

github.com/msdanyg搜索与检索5910 周前更新

代码仓库

关于 smart-connections-mcp

smart-connections-mcp 为 Obsidian 笔记提供本地语义搜索，读取 Smart Connections 插件已生成的嵌入向量，并在本机处理查询。面向需要让 MCP 客户端检索笔记和关联内容的用户，支持多个 Vault，笔记不离开设备。

主要功能

01跨一个或多个 Vault 语义搜索
02查找相似笔记
03遍历笔记关联图
04读取笔记及指定区块
05查看 Vault 状态与统计

适用场景

01按含义查找旧笔记
02探索相关主题与笔记
03提取笔记中的指定区块

MCP 相关

该 MCP 服务向客户端提供笔记搜索、相似笔记、关联图、内容读取及 Vault 统计工具。查询嵌入在本地运行，不调用云服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "msdanyg-smart-connections": {
      "command": "npx",
      "args": [
        "-y",
        "smart-connections-mcp"
      ],
      "env": {
        "SMART_VAULT_PATH": "<SMART_VAULT_PATH>"
      }
    }
  }
}

启动命令npx -y smart-connections-mcp

需要配置的环境变量

SMART_VAULT_PATHOne or more absolute Obsidian vault paths, comma-separated (alias: SMART_VAULT_PATHS)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmsmart-connections-mcp2.0.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Smart Connections MCP 服务

让 Claude 真正拥有 Obsidian 知识库的语义记忆。 一个按含义搜索笔记的 MCP 服务——复用 Smart Connections Obsidian 插件已生成的嵌入向量，并在本地运行相同的嵌入模型来理解你的查询。不调用云端服务；你的知识库永远不会离开你的设备。

功能

search_notes — 在一个或多个知识库中进行语义搜索。匹配整篇笔记以及单个区块，并返回按相似度排序且附带内容摘要的结果。
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"
      }
    }
  }
}

可以使用一个或多个知识库——多个路径之间用逗号分隔。

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

工作原理

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。

支持 Markdown

登录后评论