graphify 導(dǎo)出流水線全解Wiki、Neo4j、FalkorDB、SVG、GraphML 與 MCP 服務(wù)的源碼級實(shí)操【免費(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/graph/graphifygraphify 在完成本地 AST 抽取后真正決定知識圖譜“能走向多遠(yuǎn)”的是它的導(dǎo)出層。本文以 Kilo 技能包中的references/exports.md參考文檔為主線完整覆蓋--wiki、--neo4j/--neo4j-push、--falkordb/--falkordb-push、--svg、--graphml、--mcp六個(gè)導(dǎo)出標(biāo)志對應(yīng)的命令、默認(rèn)值與憑據(jù)處理方式并逐條對照 graphify/cli.py、graphify/exporters/graphdb.py 等源碼說明每種導(dǎo)出的底層實(shí)現(xiàn)與可驗(yàn)證的測試依據(jù)。讀完你可以獨(dú)立完成從生成 Wiki 到把圖推送到圖數(shù)據(jù)庫、再到讓其他 Agent 通過 MCP 實(shí)時(shí)查詢圖譜的全套操作。導(dǎo)出步驟的調(diào)度規(guī)則每個(gè) Step 只服務(wù)于自己的 Flag參考文檔graphify/skills/kilo/references/exports.md的開篇就定下了一條調(diào)度原則該參考文檔只在用戶傳了某個(gè)導(dǎo)出標(biāo)志時(shí)才加載且每個(gè) Step 只在其對應(yīng)標(biāo)志存在時(shí)執(zhí)行。這與主技能文檔 graphify/skill-kilo.md 中的標(biāo)志清單一一對應(yīng)/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。也就是說一次不帶任何標(biāo)志的默認(rèn)運(yùn)行不會(huì)觸發(fā)下面任何導(dǎo)出動(dòng)作全部六個(gè) Step 加上 benchmark 都是按需觸發(fā)的。在 CLI 層面這些標(biāo)志最終都收斂到graphify export format子命令由 graphify/cli.py 中的subcmd not in (html, callflow-html, obsidian, wiki, svg, graphml, neo4j, falkordb)分支統(tǒng)一分發(fā)所有導(dǎo)出默認(rèn)從graphify-out/graph.json讀取圖從同目錄的.graphify_labels.json與.graphify_analysis.json讀取社區(qū)標(biāo)簽與社區(qū)劃分并可用--graph PATH/--labels PATH顯式覆蓋。Step 6bWiki 導(dǎo)出僅當(dāng)--wiki文檔給出的命令與執(zhí)行時(shí)機(jī)約束graphify export wiki只有在原始命令顯式帶了--wiki時(shí)才運(yùn)行本步驟并且必須在 Step 9清理之前執(zhí)行確保.graphify_labels.json仍然可用?！跋葘?dǎo)出、后清理”不是隨意的順序要求。從源碼看CLI 的 wiki 分支graphify/cli.py會(huì)讀取.graphify_analysis.json中的communities、cohesion與gods并在graphify-out/wiki/目錄下調(diào)用 graphify/wiki.py 的to_wiki生成文章。這里有兩條值得注意的防護(hù)邏輯缺失社區(qū)數(shù)據(jù)時(shí)拒絕導(dǎo)出如果.graphify_analysis.json缺失或?yàn)榭誄LI 會(huì)直接報(bào)錯(cuò)退出——“refusing to export wiki to prevent data loss”并提示先運(yùn)行g(shù)raphify extract .或graphify cluster-only .重新生成社區(qū)數(shù)據(jù)。輸出結(jié)構(gòu)生成成功后打印Wiki: {n} articles written to .../wiki/并指出wiki/index.md是 agent 的入口。graphify/wiki.py 的模塊注釋說明了產(chǎn)物形態(tài)Wikipedia 風(fēng)格的 Markdown 文章包含index.md 每個(gè)社區(qū)一篇文章 god node 文章且刻意做成agent 可爬取——文章間用原始相對鏈接而非 Obsidian 的[[wiki link]]互鏈非 ASCII 字符CJK、西里爾等在 slug 中不被剝離鏈接目標(biāo)與磁盤文件名逐字一致_safe_filename與_md_link的共同設(shè)計(jì)見 graphify/wiki.py。Wiki 導(dǎo)出的行為有專門的測試覆蓋見 tests/test_wiki.py。Step 7Neo4j 導(dǎo)出僅當(dāng)--neo4j或--neo4j-push文檔區(qū)分了兩種形態(tài)形態(tài)一--neo4j——生成 Cypher 文件供手工導(dǎo)入graphify export neo4j形態(tài)二--neo4j-push uri——直推運(yùn)行中的 Neo4j 實(shí)例未提供憑據(jù)時(shí)向用戶索取graphify export neo4j --push bolt://localhost:7687 --user neo4j --password PASSWORD默認(rèn) URI 為bolt://localhost:7687默認(rèn)用戶為neo4j使用MERGE語義重復(fù)執(zhí)行不會(huì)產(chǎn)生重復(fù)節(jié)點(diǎn)可安全重跑。源碼層面這兩條路徑的分工很清晰graphify/cli.py不帶--push時(shí)調(diào)用 graphify/export.py 的to_cypher在graphify-out/cypher.txt中為每個(gè)節(jié)點(diǎn)生成MERGE (n:{Filetype} {id, label})、為每條邊生成MATCH (a), (b) MERGE (a)-[:REL {confidence}]-(b)。Cypher 字符串經(jīng)過_cypher_escape轉(zhuǎn)義反引號、引號、換行、CR、控制字節(jié)節(jié)點(diǎn) label 與關(guān)系類型這兩個(gè)無法在 Cypher 中安全轉(zhuǎn)義的標(biāo)識符位置則做[A-Za-z0-9_]白名單清洗非法時(shí)回退為Entity/RELATES_TO見 graphify/export.py。CLI 提示的導(dǎo)入方式是cypher-shell graphify-out/cypher.txt。帶--push時(shí)調(diào)用 graphify/exporters/graphdb.py 的push_to_neo4j通過官方 Python 驅(qū)動(dòng)直連。前置依賴是pip install neo4j缺失時(shí)拋出帶安裝提示的 ImportError。推送時(shí)只攜帶標(biāo)量屬性并剔除下劃線開頭的內(nèi)部屬性節(jié)點(diǎn)會(huì)額外寫入所屬community編號節(jié)點(diǎn)與關(guān)系均使用MERGE ... SET ... 參數(shù)化查詢與文檔“safe to re-run”的描述一致。函數(shù)返回{nodes: N, edges: M}CLI 打印Pushed to Neo4j: N nodes, M edges。兩個(gè)安全細(xì)節(jié)值得實(shí)操時(shí)留意密碼不留在 argv 上CLI 優(yōu)先讀取環(huán)境變量NEO4J_PASSWORD顯式--password可覆蓋F-031見 graphify/cli.py且--push場景下若拿不到密碼會(huì)直接報(bào)錯(cuò)退出。憑據(jù)清洗label 清洗在 graphify/exporters/graphdb.py 中標(biāo)注為“prevent Cypher injection”把任意 label 壓回[A-Za-z0-9_]。Step 7aFalkorDB 導(dǎo)出僅當(dāng)--falkordb或--falkordb-push文檔對--falkordb的告誡非常具體生成的語句是 OpenCypher但 FalkorDB 的GRAPH.QUERY一次只執(zhí)行一條語句沒有 Neo4jcypher-shell那樣的批量腳本導(dǎo)入所以加載圖應(yīng)優(yōu)先使用--falkordb-push僅當(dāng)你想要可移植的cypher.txt產(chǎn)物時(shí)才用文件導(dǎo)出。# 生成可移植的 OpenCypher 文件 graphify export falkordb# 直推運(yùn)行中的 FalkorDB 實(shí)例憑據(jù)可選僅當(dāng)實(shí)例要求鑒權(quán)時(shí)才向用戶索取 graphify export falkordb --push falkordb://localhost:6379默認(rèn) URI 為falkordb://localhost:6379文檔特別指出scheme 只是信息性的——redis://或直接host:port都等價(jià)鑒權(quán)可選目標(biāo)圖名默認(rèn)graphify同樣使用 MERGE可安全重跑。實(shí)現(xiàn)上push_to_falkordbgraphify/exporters/graphdb.py的 docstring 把與 Neo4j 路徑的差異逐條列出與文檔描述完全吻合前置依賴pip install falkordb通過FalkorDB(host, port, username, password)連接只從 URI 解析 host/port默認(rèn)端口 6379因此三種 URI 寫法等價(jià)通過db.select_graph(graph_name)選擇命名圖默認(rèn)graphify同一實(shí)例內(nèi)按圖名隔離查詢經(jīng)graph.query(cypher, params)執(zhí)行沒有 session 對象鑒權(quán)可選FalkorDB 默認(rèn)無憑據(jù)運(yùn)行。代碼里有一個(gè)細(xì)節(jié)——只有提供了password才會(huì)發(fā)送用戶名否則匿名連接并忽略 bolt 風(fēng)格默認(rèn)用戶名如neo4j因?yàn)?FalkorDB 會(huì)把未知 ACL 用戶拒絕見 graphify/exporters/graphdb.pyMERGE 語義與 Neo4j 路徑一致返回{nodes: N, edges: M}。不帶--push時(shí) CLI 復(fù)用to_cypher寫出cypher.txt但會(huì)額外打印一段提示由于GRAPH.QUERY逐條執(zhí)行、沒有批量腳本導(dǎo)入應(yīng)改用graphify export falkordb --push falkordb://localhost:6379加載graphify/cli.py。密碼同樣支持環(huán)境變量FALKORDB_PASSWORD替代--passwordgraphify/cli.py。該路徑的集成測試見 tests/test_falkordb_integration.py。Step 7b 與 7cSVG 和 GraphML 導(dǎo)出這兩個(gè)是最輕量的靜態(tài)產(chǎn)物文檔各給出一條命令# Step 7b - 僅當(dāng) --svg graphify export svg# Step 7c - 僅當(dāng) --graphml graphify export graphml從 CLI 實(shí)現(xiàn)看graphify/cli.pysvg分支調(diào)用 graphify/export.py 的to_svg輸出graphify-out/graph.svg成功時(shí)提示 “graph.svg written - embeds in Obsidian, Notion, GitHub READMEs”graphml分支調(diào)用to_graphml輸出graphify-out/graph.graphml提示 “open in Gephi, yEd, or any GraphML tool”。兩者都接受--graph/--labels參數(shù)svg 支持--labelsgraphml 僅--graph見 CLI 用法說明 graphify/cli.py。GraphML 路徑在寫盤前會(huì)用_strip_xml_illegal剔除 XML 1.0 無法承載的控制字符如終端 ANSI 轉(zhuǎn)義、某些源碼里的表單進(jìn)符避免單個(gè)標(biāo)簽毀掉整個(gè)導(dǎo)出graphify/export.py。Step 7dMCP Server僅當(dāng)--mcp文檔給出的啟動(dòng)命令$(cat graphify-out/.graphify_python) -m graphify.serve graphify-out/graph.json這啟動(dòng)一個(gè)stdio MCP server把知識圖譜暴露成七個(gè)工具供 Claude Desktop 或任何 MCP 兼容的 Agent 編排器實(shí)時(shí)查詢query_graph、get_node、get_neighbors、get_community、god_nodes、graph_stats、shortest_path。這七個(gè)工具名與 graphify/serve.py 中l(wèi)ist_tools注冊的name完全一致可以逐一對上。文檔同時(shí)指出了在 Claude Desktop 中配置的三個(gè)坑配置方式如下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] } } }三個(gè)坑分別是Claude Desktop 不會(huì)執(zhí)行$(...)命令替換在uv tool install場景下系統(tǒng)python3無法導(dǎo)入 graphify 包因此必須把command寫成cat graphify-out/.graphify_python打印出的絕對解釋器路徑而不是 shell 動(dòng)態(tài)展開。服務(wù)端自身還有若干與文檔互補(bǔ)的運(yùn)行細(xì)節(jié)graphify/serve.py圖文件必須是.json且存在、受大小上限檢查保護(hù)并支持GRAPHIFY_MAX_CONTEXTS環(huán)境變量控制多項(xiàng)目上下文的 LRU 容量默認(rèn) 8。查詢工具query_graph的實(shí)現(xiàn)在 _query_graph_text 一帶shortest_path則通過 NetworkX 的nx.shortest_path在有向/無向圖上求路徑graphify/serve.py。Step 8Token 縮減基準(zhǔn)測試僅當(dāng) total_words 5000文檔的觸發(fā)條件與行為如果graphify-out/.graphify_detect.json中的total_words大于 5,000則運(yùn)行g(shù)raphify benchmark把輸出直接打印在聊天里。若total_words 5000則靜默跳過——小語料下圖的價(jià)值在于結(jié)構(gòu)清晰度而非 token 壓縮。CLI 的benchmark分支graphify/cli.py會(huì)先從.graphify_detect.json讀取total_words作為語料規(guī)模再調(diào)用 graphify/benchmark.py 的run_benchmark與print_benchmark。實(shí)現(xiàn)細(xì)節(jié)可以幫你正確解讀輸出語料 token 估算按“100 words ≈ 133 tokens”換算corpus_words * 100 // 75字符級估算按每 4 字符約 1 tokengraphify/benchmark.py查詢成本模擬對 5 個(gè)內(nèi)置樣例問題如 “how does authentication work”先用問題詞元對節(jié)點(diǎn) label 打分取 top-3 起點(diǎn)再做 3 層 BFS把子圖內(nèi)的NODE/EDGE行折算成 token 數(shù)_query_subgraph_tokens輸出報(bào)告打印語料 token、圖規(guī)模nodes/edges、平均查詢 token 成本與總體縮減比以及每個(gè)問題各自的Nx縮減系數(shù)graphify/benchmark.py。該基準(zhǔn)有專門的單測覆蓋見 tests/test_benchmark.py。小結(jié)按標(biāo)志對照表收尾Flag命令產(chǎn)物 / 默認(rèn)值關(guān)鍵約束--wikigraphify export wikigraphify-out/wiki/index.md為 agent 入口需在 Step 9 清理前運(yùn)行缺社區(qū)數(shù)據(jù)直接拒絕導(dǎo)出--neo4jgraphify export neo4jgraphify-out/cypher.txt需cypher-shell批量導(dǎo)入需pip install neo4jpush 時(shí)--neo4j-pushgraphify export neo4j --push bolt://localhost:7687 --user neo4j --password PASSWORD直推 Neo4jMERGE 可重跑可用NEO4J_PASSWORD替代明文密碼--falkordbgraphify export falkordbgraphify-out/cypher.txtOpenCypherGRAPH.QUERY逐條執(zhí)行加載優(yōu)先--push--falkordb-pushgraphify export falkordb --push falkordb://localhost:6379直推 FalkorDB默認(rèn)圖名graphifyscheme 信息性、鑒權(quán)可選可用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 個(gè)查詢工具Claude Desktop 配置需用絕對解釋器路徑自動(dòng)total_words 5000graphify benchmark打印 token 縮減報(bào)告語料過小則靜默跳過所有命令都以本地生成的graphify-out/graph.json為單一事實(shí)源導(dǎo)出物彼此獨(dú)立、可單獨(dú)重跑圖數(shù)據(jù)庫類導(dǎo)出統(tǒng)一采用 MERGE 冪等語義憑據(jù)處理上優(yōu)先環(huán)境變量——這套組合讓導(dǎo)出層在“可移植產(chǎn)物”與“直連推送”之間提供了完整的可選項(xiàng)?！久赓M(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/graph/graphify創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考