Nexus MCP for Obsidian

使用说明(Markdown要点):

  • 项目简介
    • Nexus 将 Obsidian vault 变成一个 MCP 服务器工作区,面向对话式 AI copilots 提供安全、结构化的上下文和功能能力,数据本地化存储,支持多工具/资源域和自定义提示模板。
  • 主要功能点
    • 资源与数据管理:对笔记、文件夹、前端元信息等资源进行读取、创建、更新以及批量操作
    • 工具注册与执行:定义工具域,允许 LLM 调用外部功能(如文本检索、笔记读写、记忆管理等)
    • Prompt 模板与渲染:支持可定制的提示模板,便于 LLM 交互模式的灵活配置
    • 会话与存储:工作区、会话、内存、历史记录等本地存储与索引机制
    • 本地与多 provider 支持:支持多家 LLM 提供商(如 OpenAI、Anthropic、Google 等)以及本地服务(Ollama、LM Studio 等),优先走本地化/直接 HTTP 调用
    • 多 Vault 独立实例:每个 vault 独立运行一个 MCP 服务实例,彼此不冲突
    • 传输协议与 JSON-RPC:通过 JSON-RPC 接收请求并返回响应,支持多种传输通道(如 Stdio、SSE、WebSocket),便于与不同客户端对接
  • 安装步骤
    • 下载最新发行包,放置到 Obsidian 插件目录(.obsidian/plugins/nexus/),包括 manifest.json、styles.css、main.js、connector.js
    • 在 Obsidian 设置中启用 Nexus 插件,重启以完成首次初始化
    • 读取 README 中的配置说明,确保本地环境符合 Node.js≥18 的要求
  • 服务器配置(给 MCP 客户端使用的配置信息,示例以一个 vault 为例,实际可为每个 vault 配置一个独立服务器) -serverName: nexus-your-vault -command: node -args: ["/path/to/Vault/.obsidian/plugins/nexus/connector.js"] 注:该配置用于 MCP 客户端在本地启动并连接到 Nexus 服务器。MCP 客户端不需要包含服务器实现代码,仅需知道服务器的启动命令和参数即可建立连接。
  • 基本使用方法
    • 在 Claude Desktop 或其他 MCP 客户端中添加 Nexus 服务器(按上面的配置启动命令),并确保 vault 名称一致以避免跨 vault 冲突
    • 启动 Obsidian 并确保 Nexus 插件已加载,NCP 服务启动后客户端即可向 Nexus 请求资源、调用工具、获取 Prompts
    • 使用内置工具和提示模板进行对话式交互,Nexus 将在本地完成资源访问与上下文管理,输出 JSON-RPC 风格的响应

服务器信息