知识图谱智能分析工具

Synapse是一个为Obsidian笔记库提供智能分析和连接功能的工具,帮助用户发现知识图谱中的联系、缺失和潜在改进点。

  • by DTG404
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 digitalghost404/dtg-obsidian-mcp

使用说明

突触

黑曜石拱顶的连接层。

你的笔记充满了想法,但孤立的想法只是文本。 突触 是一个 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?"

📄 许可证

麻省理工学院 随着 公地条款

可出于个人和非商业目的自由使用、修改和分发。您不得销售该软件或将其作为付费产品或服务提供。