Graphify — 文件夹级知识图谱工具(83K⭐)

Codex 核验(2026-10-10):当前官方仓库为 Graphify-Labs/graphify,默认分支 v8;10 月 9 日 API 快照为 124,844 stars、Apache-2.0,本文 83K 等数字保留为历史快照。当前代码 AST 建图可本地、确定性且不调用 LLM;文档、PDF、图片等语义处理使用宿主模型或配置后端,不能把整个流程概括为零模型费用、完全不外发。README 明确提供可选 graphifyy[mcp] stdio 服务,skill 和 MCP 是不同接入方式;小样本 context reduction 不等于整项任务账单下降。

研究日期:2026-07-13 | 来源:Sticky Notes Board

概述

Graphify-Labs/graphify(原名 glennreyes/graphify)是一款 Claude Code skill,可将任意文件夹(代码、文档、论文、截图、白板照片等)转化为可查询的知识图谱。当前 83,352 ⭐。

pip install graphifyy && graphify install
# 然后在 Claude Code 中:
/graphify .   # 在当前目录构建知识图谱
/graphify ./raw --mode deep   # 更激进的关系抽取
/graphify ./raw --mcp          # 启动 MCP stdio 服务

核心指标

指标值
⭐83,352
许可MIT
技术栈NetworkX + Leiden (graspologic) + tree-sitter + Claude + vis.js
输入代码 / Markdown / PDF / 图片 / 截图 / 白板照片
输出HTML 图谱 / Obsidian vault / Wiki / graph.json / SVG / GraphML / Neo4j Cypher
Token 缩减71.5x(52 文件混合语料测试)
MCP✅ 内置 stdio 服务器

7 阶段流水线

detect() → extract() → build_graph() → cluster() → analyze() → report() → export()

每阶段是独立模块,通过 nx.Graph / dict 通信,零共享状态:

模块功能
detect.py收集文件(按扩展名过滤)
extract.py每文件提取节点+边(tree-sitter AST + call-graph + Claude vision)
build.py合并提取结果 → NetworkX Graph
cluster.pyLeiden 社区检测 → 每个节点打 community 标签
analyze.py识别 God Nodes(中心节点)、意外连接、推荐问题
report.py渲染 GRAPH_REPORT.md
export.py导出到 Obsidian / HTML / SVG / GraphML / Neo4j

置信度标签(关键设计)

每条边标注来源置信度,透明区分”发现”与”猜测”:

标签含义
EXTRACTED源文件中明确声明(如 import 语句、直接调用)
INFERRED合理推断(如 call-graph 二次传递、上下文共现)
AMBIGUOUS不确定,标记给人工审查

MCP 工具

内置 MCP stdio 服务器,暴露 7 个工具:

工具功能
query_graphBFS/DFS 搜索知识图谱,返回子图文本
get_node按标签/ID 查节点详情
get_neighbors查指定节点所有邻居(可按关系类型过滤)
get_community按社区 ID 查全部节点
god_nodes返回度数最高的节点(核心抽象)
graph_stats节点/边/社区/置信度分布统计
shortest_path两概念间最短路径

与 gbrain 的关联分析

可直接借鉴的设计

  1. 置信度标签 — gbrain 的图边可以引入 confidence: extracted|inferred|ambiguous,提升用户对 AI 生成关系的信任
  2. MCP 暴露图查询 — gbrain 已有 query / search / think 工具,但 Graphify 的 query_graph(BFS/DFS 子图提取)模式简洁有效
  3. God Nodes 分析 — 识别知识图谱中的”枢纽节点”可帮助理解哪些概念连接最多,利于知识管理
  4. 社区检测 — gbrain 可以用 Leiden 聚类自动发现知识社区,辅助 find_anomalies
  5. Pipeline 架构 — detect→extract→build→cluster→analyze→report→export 每步独立可替换

gbrain 已有但 Graphify 没有的

维度gbrainGraphify
持久存储PostgreSQL + pgvectorgraph.json 文件
长期记忆永久存储 + 版本历史每次重跑重建
多 Agent 共享✅ NATS + 全局 brain❌ 单 Agent
语义搜索向量 + BM25 + RRF仅 BFS/DFS
事实提取extract_facts + recall一次性分析

集成可能性

Graphify 的 MCP 服务器可以直接注册为 Hermes 的外部 MCP 工具,在需要时加载代码库知识图谱。但与现有的 codebase-memory MCP 工具功能重叠——建议二选一或评估 codebase-memory + gbrain 的组合是否已覆盖。

其他参考

结论

Graphify 是目前最成功的知识图谱 AI Skill(83K⭐),其核心贡献不是技术革新,而是设计模式创新:将”文件夹→知识图谱”做成一个可交付的、透明的、低门槛的工具。对 gbrain 来说,最有价值的借鉴是 置信度标签系统 和 MCP 图查询接口设计——这两者可以低成本合并到现有系统中。