Synapse

连接你的 AI 与笔记之间的神经系统。

连接任何 AI 到你的 Obsidian 知识库的 MCP 服务器。适用于 Claude、ChatGPT、Cursor、Windsurf 以及任何兼容 MCP 的客户端。从手机保存文章、跨笔记提问、构建复合知识库。

30 秒快速设置

Claude Desktop

1. 打开配置文件：Mac ~/Library/Application Support/Claude/claude_desktop_config.json | Windows %APPDATA%\Claude\claude_desktop_config.json

2. 将 Synapse 添加到 mcpServers 对象中：

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/obsidian-vault"]
    }
  }
}

3. 重启 Claude Desktop。Synapse 工具将自动出现。

Claude Code

添加到主目录下的 .claude/.mcp.json：

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/vault"]
    }
  }
}

Claude.ai / ChatGPT / 任何远程 AI

在本地运行 Synapse 并通过免费隧道暴露它：

# Terminal 1: Start Synapse
npx synapse-obsidian /path/to/vault --http --port 3777

# Terminal 2: Expose it (free, no account needed)
npx cloudflared tunnel --url http://localhost:3777

复制隧道 URL。在你的 AI 客户端中添加 https://your-tunnel-url.trycloudflare.com/mcp 作为自定义 MCP 集成。

入门指南

连接后，输入：

“Help me get started with Synapse”

Synapse 将扫描你的知识库并提供三个选项：

• 使用我现有的知识库 — 检测你的文件夹结构、双向链接和命名规范。不会移动或覆盖任何内容。Synapse 会适应你的习惯。

• 建立知识库 — 创建有组织的文件夹：sources/ 用于原始内容，notes/ 用于整理后的知识，outputs/ 用于查询结果。最适合专注的研究主题。

• 自定义 — 你告诉 Synapse 你希望如何组织内容。

它还会询问你使用知识库的目的（研究、商业、学术、生活管理），以便为你量身定制体验。

你可以做什么

从任何地方保存任何内容

“Save this article: https://example.com/interesting-post”

抓取页面，转换为 Markdown，并保存到你的知识库中。在手机上也能使用。

跨笔记提问

“What do my notes say about pricing strategy?”

搜索你的知识库，阅读相关文件，并综合生成带有引用的答案。

构建复合维基

“Process all new articles in my vault”

将原始来源转化为摘要、概念页面、实体页面——所有内容都通过双向链接相互关联。每一个答案都会反馈到知识库中。

检查笔记健康状况

“Run a health check on my vault”

查找损坏的链接、孤立页面、缺失的元数据（frontmatter）和过时的内容。并尽可能修复它们。

所有工具

工作原理

Synapse 是一个 MCP 服务器 — 一种用于将 AI 连接到工具和数据的开放协议。它赋予你的 AI 对知识库的读/写访问权限（仅限知识库目录，处于沙盒环境中）。

• Stdio (默认) — 用于桌面 AI 应用 (Claude Desktop 等)

• HTTP (--http) — 用于基于浏览器的 AI (Claude.ai, ChatGPT 等)，通过隧道连接

• Cloud (--cloud) — 带有 Google Drive OAuth 的托管模式（即将推出）

你的知识库只是一个 Markdown 文件文件夹。Synapse 不需要运行 Obsidian — 它适用于任何文件夹。

要求

• Node.js 18+ (使用 node -v 检查)

• 一个 Obsidian 知识库或任何 Markdown 文件文件夹

• 任何兼容 MCP 的 AI 客户端

许可证

MIT — MainLoop Systems