Graphify — 面向 AI 编码助手的知识图谱

什么是 Graphify？

Graphify 是为 AI 编码助手（如 Claude Code、OpenAI Codex、OpenCode）打造的多模态知识图谱构建器。它结合 Tree-sitter 静态分析与 LLM 语义抽取，将整个仓库（源代码、文档、研究论文、图示）转换为可交互图谱，同时解释代码“做什么”和“为什么这样设计”。项目由 Safi Shamsi 维护，采用 MIT 许可证，并建立在 NetworkX 与 Tree-sitter 等成熟库之上。

核心能力

Graphify 将静态分析、语义抽取和图聚类统一为一个可被 AI 编码助手直接调用的技能。

架构与流水线

Graphify 采用多阶段流水线。每个阶段都是独立模块，贡献者可以按需扩展。

配套模块包括用于 URL 抓取的 `ingest.py`、语义缓存 `cache.py`、输入校验 `security.py`、实时更新 `watch.py` 和 MCP 服务 `serve.py`。

本地安装与运行

使用 Python 3.12 和 uv 从仓库安装 Graphify AI。包名为 private-context-mcp，CLI 命令为 private-context。

# 需要 Python 3.12 和 uv；请在 Graphify AI 仓库根目录执行
uv sync --extra dev --extra cloud --no-editable \
  --reinstall-package private-context-mcp

# 验证本地安装
uv run --no-sync private-context doctor

# 启动本地 stdio MCP 服务
uv run --no-sync private-context serve --transport stdio

这些命令使用 Graphify AI 锁定的依赖和本地运行时；如无需本地安装，可直接使用 app.graaph.org 托管控制台。

实践示例

仓库内置可复现语料，展示 Graphify 在小型库与大型代码+论文混合语料上的表现。

对比

Graphify 与代码智能领域相邻开源项目的关系。

安全、许可与可信性

Graphify 采用 MIT 许可证。核心依赖 NetworkX（BSD）和 Tree-sitter（MIT）均为宽松开源协议。项目不做遥测。唯一外部网络调用是语义抽取步骤，使用你自己的模型 API Key；仅发送文档语义描述，不发送原始源码。URL 被限制为 http/https，下载有大小和超时限制，输出路径有包含校验，节点标签做 HTML 转义，以防 SSRF、Cypher 注入与 XSS。

深入了解 Graphify

查看更多指南，理解 Graphify 如何为 AI 编码助手构建、聚类并服务知识图谱。