graphify 导出流水线全解Wiki、Neo4j、FalkorDB、SVG、GraphML 与 MCP 服务的源码级实操【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify 在完成本地 AST 抽取后真正决定知识图谱“能走向多远”的是它的导出层。本文以 Kilo 技能包中的references/exports.md参考文档为主线完整覆盖--wiki、--neo4j/--neo4j-push、--falkordb/--falkordb-push、--svg、--graphml、--mcp六个导出标志对应的命令、默认值与凭据处理方式并逐条对照 graphify/cli.py、graphify/exporters/graphdb.py 等源码说明每种导出的底层实现与可验证的测试依据。读完你可以独立完成从生成 Wiki 到把图推送到图数据库、再到让其他 Agent 通过 MCP 实时查询图谱的全套操作。导出步骤的调度规则每个 Step 只服务于自己的 Flag参考文档graphify/skills/kilo/references/exports.md的开篇就定下了一条调度原则该参考文档只在用户传了某个导出标志时才加载且每个 Step 只在其对应标志存在时执行。这与主技能文档 graphify/skill-kilo.md 中的标志清单一一对应/graphify path --svg # also export graph.svg /graphify path --graphml # export graph.graphml /graphify path --neo4j # generate graphify-out/cypher.txt /graphify path --neo4j-push bolt://localhost:7687 # push directly to Neo4j /graphify path --falkordb # generate graphify-out/cypher.txt /graphify path --falkordb-push falkordb://localhost:6379 # push directly to FalkorDB /graphify path --mcp # start MCP stdio server /graphify path --wiki # agent-crawlable wikiskill 文档中也有同样的说明这些步骤“only when their flag is present … or, for the token-reduction benchmark, whentotal_wordsexceeds 5,000. A default run with no export flags skips all of them”见 graphify/skill-kilo.md。也就是说一次不带任何标志的默认运行不会触发下面任何导出动作全部六个 Step 加上 benchmark 都是按需触发的。在 CLI 层面这些标志最终都收敛到graphify export format子命令由 graphify/cli.py 中的subcmd not in (html, callflow-html, obsidian, wiki, svg, graphml, neo4j, falkordb)分支统一分发所有导出默认从graphify-out/graph.json读取图从同目录的.graphify_labels.json与.graphify_analysis.json读取社区标签与社区划分并可用--graph PATH/--labels PATH显式覆盖。Step 6bWiki 导出仅当--wiki文档给出的命令与执行时机约束graphify export wiki只有在原始命令显式带了--wiki时才运行本步骤并且必须在 Step 9清理之前执行确保.graphify_labels.json仍然可用。“先导出、后清理”不是随意的顺序要求。从源码看CLI 的 wiki 分支graphify/cli.py会读取.graphify_analysis.json中的communities、cohesion与gods并在graphify-out/wiki/目录下调用 graphify/wiki.py 的to_wiki生成文章。这里有两条值得注意的防护逻辑缺失社区数据时拒绝导出如果.graphify_analysis.json缺失或为空CLI 会直接报错退出——“refusing to export wiki to prevent data loss”并提示先运行graphify extract .或graphify cluster-only .重新生成社区数据。输出结构生成成功后打印Wiki: {n} articles written to .../wiki/并指出wiki/index.md是 agent 的入口。graphify/wiki.py 的模块注释说明了产物形态Wikipedia 风格的 Markdown 文章包含index.md 每个社区一篇文章 god node 文章且刻意做成agent 可爬取——文章间用原始相对链接而非 Obsidian 的[[wiki link]]互链非 ASCII 字符CJK、西里尔等在 slug 中不被剥离链接目标与磁盘文件名逐字一致_safe_filename与_md_link的共同设计见 graphify/wiki.py。Wiki 导出的行为有专门的测试覆盖见 tests/test_wiki.py。Step 7Neo4j 导出仅当--neo4j或--neo4j-push文档区分了两种形态形态一--neo4j——生成 Cypher 文件供手工导入graphify export neo4j形态二--neo4j-push uri——直推运行中的 Neo4j 实例未提供凭据时向用户索取graphify export neo4j --push bolt://localhost:7687 --user neo4j --password PASSWORD默认 URI 为bolt://localhost:7687默认用户为neo4j使用MERGE语义重复执行不会产生重复节点可安全重跑。源码层面这两条路径的分工很清晰graphify/cli.py不带--push时调用 graphify/export.py 的to_cypher在graphify-out/cypher.txt中为每个节点生成MERGE (n:{Filetype} {id, label})、为每条边生成MATCH (a), (b) MERGE (a)-[:REL {confidence}]-(b)。Cypher 字符串经过_cypher_escape转义反引号、引号、换行、CR、控制字节节点 label 与关系类型这两个无法在 Cypher 中安全转义的标识符位置则做[A-Za-z0-9_]白名单清洗非法时回退为Entity/RELATES_TO见 graphify/export.py。CLI 提示的导入方式是cypher-shell graphify-out/cypher.txt。带--push时调用 graphify/exporters/graphdb.py 的push_to_neo4j通过官方 Python 驱动直连。前置依赖是pip install neo4j缺失时抛出带安装提示的 ImportError。推送时只携带标量属性并剔除下划线开头的内部属性节点会额外写入所属community编号节点与关系均使用MERGE ... SET ... 参数化查询与文档“safe to re-run”的描述一致。函数返回{nodes: N, edges: M}CLI 打印Pushed to Neo4j: N nodes, M edges。两个安全细节值得实操时留意密码不留在 argv 上CLI 优先读取环境变量NEO4J_PASSWORD显式--password可覆盖F-031见 graphify/cli.py且--push场景下若拿不到密码会直接报错退出。凭据清洗label 清洗在 graphify/exporters/graphdb.py 中标注为“prevent Cypher injection”把任意 label 压回[A-Za-z0-9_]。Step 7aFalkorDB 导出仅当--falkordb或--falkordb-push文档对--falkordb的告诫非常具体生成的语句是 OpenCypher但 FalkorDB 的GRAPH.QUERY一次只执行一条语句没有 Neo4jcypher-shell那样的批量脚本导入所以加载图应优先使用--falkordb-push仅当你想要可移植的cypher.txt产物时才用文件导出。# 生成可移植的 OpenCypher 文件 graphify export falkordb# 直推运行中的 FalkorDB 实例凭据可选仅当实例要求鉴权时才向用户索取 graphify export falkordb --push falkordb://localhost:6379默认 URI 为falkordb://localhost:6379文档特别指出scheme 只是信息性的——redis://或直接host:port都等价鉴权可选目标图名默认graphify同样使用 MERGE可安全重跑。实现上push_to_falkordbgraphify/exporters/graphdb.py的 docstring 把与 Neo4j 路径的差异逐条列出与文档描述完全吻合前置依赖pip install falkordb通过FalkorDB(host, port, username, password)连接只从 URI 解析 host/port默认端口 6379因此三种 URI 写法等价通过db.select_graph(graph_name)选择命名图默认graphify同一实例内按图名隔离查询经graph.query(cypher, params)执行没有 session 对象鉴权可选FalkorDB 默认无凭据运行。代码里有一个细节——只有提供了password才会发送用户名否则匿名连接并忽略 bolt 风格默认用户名如neo4j因为 FalkorDB 会把未知 ACL 用户拒绝见 graphify/exporters/graphdb.pyMERGE 语义与 Neo4j 路径一致返回{nodes: N, edges: M}。不带--push时 CLI 复用to_cypher写出cypher.txt但会额外打印一段提示由于GRAPH.QUERY逐条执行、没有批量脚本导入应改用graphify export falkordb --push falkordb://localhost:6379加载graphify/cli.py。密码同样支持环境变量FALKORDB_PASSWORD替代--passwordgraphify/cli.py。该路径的集成测试见 tests/test_falkordb_integration.py。Step 7b 与 7cSVG 和 GraphML 导出这两个是最轻量的静态产物文档各给出一条命令# Step 7b - 仅当 --svg graphify export svg# Step 7c - 仅当 --graphml graphify export graphml从 CLI 实现看graphify/cli.pysvg分支调用 graphify/export.py 的to_svg输出graphify-out/graph.svg成功时提示 “graph.svg written - embeds in Obsidian, Notion, GitHub READMEs”graphml分支调用to_graphml输出graphify-out/graph.graphml提示 “open in Gephi, yEd, or any GraphML tool”。两者都接受--graph/--labels参数svg 支持--labelsgraphml 仅--graph见 CLI 用法说明 graphify/cli.py。GraphML 路径在写盘前会用_strip_xml_illegal剔除 XML 1.0 无法承载的控制字符如终端 ANSI 转义、某些源码里的表单进符避免单个标签毁掉整个导出graphify/export.py。Step 7dMCP Server仅当--mcp文档给出的启动命令$(cat graphify-out/.graphify_python) -m graphify.serve graphify-out/graph.json这启动一个stdio MCP server把知识图谱暴露成七个工具供 Claude Desktop 或任何 MCP 兼容的 Agent 编排器实时查询query_graph、get_node、get_neighbors、get_community、god_nodes、graph_stats、shortest_path。这七个工具名与 graphify/serve.py 中list_tools注册的name完全一致可以逐一对上。文档同时指出了在 Claude Desktop 中配置的三个坑配置方式如下claude_desktop_config.json{ mcpServers: { graphify: { command: absolute path from: cat graphify-out/.graphify_python, args: [-m, graphify.serve, /absolute/path/to/graphify-out/graph.json] } } }三个坑分别是Claude Desktop 不会执行$(...)命令替换在uv tool install场景下系统python3无法导入 graphify 包因此必须把command写成cat graphify-out/.graphify_python打印出的绝对解释器路径而不是 shell 动态展开。服务端自身还有若干与文档互补的运行细节graphify/serve.py图文件必须是.json且存在、受大小上限检查保护并支持GRAPHIFY_MAX_CONTEXTS环境变量控制多项目上下文的 LRU 容量默认 8。查询工具query_graph的实现在 _query_graph_text 一带shortest_path则通过 NetworkX 的nx.shortest_path在有向/无向图上求路径graphify/serve.py。Step 8Token 缩减基准测试仅当 total_words 5000文档的触发条件与行为如果graphify-out/.graphify_detect.json中的total_words大于 5,000则运行graphify benchmark把输出直接打印在聊天里。若total_words 5000则静默跳过——小语料下图的价值在于结构清晰度而非 token 压缩。CLI 的benchmark分支graphify/cli.py会先从.graphify_detect.json读取total_words作为语料规模再调用 graphify/benchmark.py 的run_benchmark与print_benchmark。实现细节可以帮你正确解读输出语料 token 估算按“100 words ≈ 133 tokens”换算corpus_words * 100 // 75字符级估算按每 4 字符约 1 tokengraphify/benchmark.py查询成本模拟对 5 个内置样例问题如 “how does authentication work”先用问题词元对节点 label 打分取 top-3 起点再做 3 层 BFS把子图内的NODE/EDGE行折算成 token 数_query_subgraph_tokens输出报告打印语料 token、图规模nodes/edges、平均查询 token 成本与总体缩减比以及每个问题各自的Nx缩减系数graphify/benchmark.py。该基准有专门的单测覆盖见 tests/test_benchmark.py。小结按标志对照表收尾Flag命令产物 / 默认值关键约束--wikigraphify export wikigraphify-out/wiki/index.md为 agent 入口需在 Step 9 清理前运行缺社区数据直接拒绝导出--neo4jgraphify export neo4jgraphify-out/cypher.txt需cypher-shell批量导入需pip install neo4jpush 时--neo4j-pushgraphify export neo4j --push bolt://localhost:7687 --user neo4j --password PASSWORD直推 Neo4jMERGE 可重跑可用NEO4J_PASSWORD替代明文密码--falkordbgraphify export falkordbgraphify-out/cypher.txtOpenCypherGRAPH.QUERY逐条执行加载优先--push--falkordb-pushgraphify export falkordb --push falkordb://localhost:6379直推 FalkorDB默认图名graphifyscheme 信息性、鉴权可选可用FALKORDB_PASSWORD--svggraphify export svggraphify-out/graph.svg可嵌入 Obsidian / Notion / README--graphmlgraphify export graphmlgraphify-out/graph.graphmlGephi、yEd 等工具可打开--mcp$(cat graphify-out/.graphify_python) -m graphify.serve graphify-out/graph.jsonstdio MCP server7 个查询工具Claude Desktop 配置需用绝对解释器路径自动total_words 5000graphify benchmark打印 token 缩减报告语料过小则静默跳过所有命令都以本地生成的graphify-out/graph.json为单一事实源导出物彼此独立、可单独重跑图数据库类导出统一采用 MERGE 幂等语义凭据处理上优先环境变量——这套组合让导出层在“可移植产物”与“直连推送”之间提供了完整的可选项。【免费下载链接】graphifyTurn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.项目地址: https://gitcode.com/GitHub_Trending/graph/graphify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考