突触
黑曜石拱顶的连接层。
你的笔记充满了想法，但孤立的想法只是文本。 突触 是一个 MCP（模型上下文协议） 为克劳德提供黑曜石金库神经系统的服务器。它不仅仅是读写文件。它追踪想法之间的路径，表面缺失的连接，按主题对笔记进行分类，标记思维中的弱点，并帮助你以大脑一直想要的方式查看你的知识图谱。
56个工具。10个类别。一个终于回过神来的金库。
______________________________________________________________________
⚡ Synapse有什么不同
每个PKM工具都可以让你存储笔记。Synapse助您一臂之力 *使用* 他们。
| 无Synapse | 有Synapse |
|---|---|
| 手动搜索相关笔记 | find_related_notes 根据主题相似性对你的跳马进行排名 |
| 不知道缺少了什么 | find_knowledge_gaps 尚未注释的曲面概念 |
| 您忘记创建的链接 | suggest_links 使用内容重叠查找未链接的连接 |
| 慢慢过时的笔记 | get_review_queue 自动显示过期的活动笔记 |
| 不知道你的保险库有多健康 | vault_report 一次性提供完整的诊断 |
| 从原始笔记中学习 | generate_flashcards 将任何音符转换为Anki就绪问答对 |
| 想知道这两个想法是如何联系在一起的 | trace_path 查找任意两个笔记之间的最短wikilink路径 |
______________________________________________________________________
🛠 工具
笔记管理
| 工具 | 说明 |
|---|---|
list_notes | 列出所有笔记，可选择按文件夹筛选 |
read_note | 阅读笔记的全部内容 |
write_note | 创建或覆盖笔记（自动创建父文件夹） |
delete_note | 按路径删除注释 |
rename_note | 重命名笔记或将其移动到新路径 |
append_to_note | 添加内容而不覆盖 |
patch_note | 查找并替换文本（第一次匹配或所有匹配项） |
首页和元数据
| 工具 | 说明 |
|---|---|
get_frontmatter | 将笔记的YAML frontmatter作为结构化JSON返回 |
set_frontmatter | 更新特定字段，同时保留其余字段 |
list_tags | 将vault中的每个标签与使用计数聚合 |
链接和图表
| 工具 | 说明 |
|---|---|
get_outgoing_links | 列出全部 [[wikilinks]] 在笔记中 |
get_backlinks | 查找链接到给定笔记的每个笔记 |
get_orphans | 查找没有传入或传出链接的笔记 |
文件夹
| 工具 | 说明 |
|---|---|
list_folders | 列出vault中的所有文件夹 |
create_folder | 创建一个文件夹（以及任何缺失的父文件夹） |
delete_folder | 删除文件夹——默认情况下是安全的， force: true 用于递归 |
每日笔记和模板
| 工具 | 说明 |
|---|---|
get_daily_note | 阅读今天（或任何日期）的每日笔记 |
create_daily_note | 创建每日笔记，可选择从模板中创建 |
list_templates | 列出Templates文件夹中的所有注释 |
create_from_template | 使用实例化模板 {{title}}, {{date}}，和自定义 {{key}} 替代品 |
搜索与查询
| 工具 | 说明 |
|---|---|
search_notes | 跨内容和文件名的全文搜索 |
search_by_tag | 按标签查找笔记 any 或 all 匹配模式 |
search_by_frontmatter | 按frontmatter键值对查找注释 |
query_notes | 按前体过滤 eq, neq, contains, gt, lt, gte, lte, exists --加排序和限制 |
get_timeline | 按时间顺序按任何日期前体字段列出注释 |
写作与工作流程
| 工具 | 说明 |
|---|---|
extract_tasks | 扫描 - [ ] vault中的复选框或单个注释 |
complete_task | 通过匹配打开的任务的确切文本来检查它 |
merge_notes | 将多个音符合并为一个音符，并可选择去除前体 |
split_note | 在标题级别拆分注释——每个部分都成为自己的文件 |
保险库智能
| 工具 | 说明 |
|---|---|
get_graph_stats | 总笔记、链接、平均连接数、按输入/输出程度排列的前笔记 |
get_hub_notes | 与笔记关联最紧密的部分——你图表中的高级神经元 |
trace_path | 查找任意两个笔记之间的最短维基链接路径 |
get_recently_modified | 最近N天内修改的注释，最近的注释排在第一位 |
保险库健康状况
| 工具 | 说明 |
|---|---|
find_broken_links | 每一个 [[wikilink]] 指向一个不存在的注释 |
find_empty_notes | 无正文内容的笔记（仅为空白或正面内容） |
vault_report | 完整诊断：断开链接、孤立、空笔记、顶部标签、文件夹大小 |
连接智能
*使Synapse不仅仅是一个文件管理器的工具。*
| 工具 | 说明 |
|---|---|
summarize_note | 结构大纲：标题、每节第一句话、字数、阅读时间 |
suggest_links | 按内容和标题重叠对未链接的笔记进行排名——建立新的联系 |
generate_moc | 自动为任何文件夹生成目录图 |
find_duplicates | 使用Jaccard相似度识别相似的音符对 |
find_knowledge_gaps | 表面粗体术语、大写短语和没有相应注释的维基链接 |
extract_concepts | 将笔记内容分类为维基链接、粗体术语、代码术语和专有名词 |
generate_summary_note | 将多个注释合成为一个结构化的概述 |
suggest_note_structure | 分析注释，并建议改进标题层次结构、前台和组织 |
cluster_notes | 按共享词汇将笔记分组到主题集群中——查看您的保险库区域 |
find_related_notes | 找到与给定笔记主题最相似的笔记 |
compare_notes | 并排：共享概念、独特内容、标签和链接重叠 |
get_note_evolution | 跟踪git历史记录中的字数、标题和链接 |
extract_quotes | 从保管库中收集所有区块报价，可选择按标签过滤 |
find_unsourced_claims | 标记没有维基链接、URL或引用的断言句子 |
generate_flashcards | 将笔记转换为与Anki兼容的问答对——检测Q:/a:块、粗体定义、标题+摘要对 |
extract_definitions | 从“X是…”编译一个术语表，然后 **Term** — definition 图案 |
get_review_queue | 标记为活动的笔记，N+天内未被触碰 |
generate_weekly_review | 过去一周修改的笔记、打开/完成的任务、活动标签和最活跃的文件夹 |
score_note_quality | 对9点评分标准进行评分：封面、标签、链接、正文长度、标题结构等 |
suggest_tags | 通过将笔记与金库中相似笔记的标记方式进行比较，推断可能的标签 |
______________________________________________________________________
🚀 设置
先决条件： Node.js 18+
git clone https://github.com/digitalghost404/obsidian-mcp.git
cd obsidian-mcp
npm install复制示例配置并填写路径：
cp .mcp.json.example .mcp.json{
"mcpServers": {
"obsidian-vault": {
"command": "node",
"args": ["/path/to/obsidian-mcp/index.js"],
"env": {
"VAULT_PATH": "/path/to/your/obsidian/vault",
"DAILY_NOTES_FOLDER": "Daily Notes",
"TEMPLATES_FOLDER": "Templates"
}
}
}
}地方 .mcp.json 在您的项目根目录中或 ~/.claude/ Claude Code将自动连接。
______________________________________________________________________
⚙️ 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
VAULT_PATH | *（必填）* | 通往黑曜石金库的绝对路径 |
DAILY_NOTES_FOLDER | Daily Notes | 用于存放每日笔记的Vault相关文件夹 |
TEMPLATES_FOLDER | Templates | 模板的Vault相对文件夹 |
______________________________________________________________________
💬 Synapse正在运行
"Run a full vault health report and fix any broken links"
"Find all notes I haven't touched in 2 weeks that are still marked active"
"What's the shortest path between my 'Systems Thinking' note and 'Habit Tracking'?"
"Generate flashcards from my Calculus notes and save them to Study/Calculus Flashcards.md"
"Cluster all notes in my Research folder by theme and show me what emerges"
"Find knowledge gaps in my 'Machine Learning' note — what concepts am I missing?"
"Score all my notes for quality and show me the ones below 50%"
"Extract every definition from my vault and compile a glossary"
"Suggest tags for this draft note based on how the rest of my vault is tagged"
"Compare my 'Atomic Habits' and 'Deep Work' notes — where do these ideas overlap?"
"Flag any unsourced claims in my essay drafts"
"Generate a weekly review — what did I work on, what's still open?"______________________________________________________________________
📄 许可证
可出于个人和非商业目的自由使用、修改和分发。您不得销售该软件或将其作为付费产品或服务提供。