LeanKG
LeanKG
用于 AI 辅助开发的轻量级知识图谱
LeanKG 是一个本地优先的知识图谱，为 AI 编码工具提供准确的代码库上下文。它会对你的代码进行索引，构建依赖关系图，并提供一个 MCP 服务器，以便 Cursor、OpenCode 和 Claude Code 等工具可以直接查询知识图谱。无需云服务，无需外部数据库。
LeanKG 如何提供帮助
graph LR
subgraph "Without LeanKG"
A1[AI Tool] -->|Scans entire codebase| B1[10,000+ tokens]
B1 --> A1
end
subgraph "With LeanKG"
A2[AI Tool] -->|13-42 tokens| C[LeanKG Graph]
C -->|Targeted subgraph| A2
end没有 LeanKG 时：AI 扫描整个代码库（约 10,000+ 个 Token）。 使用 LeanKG 时：AI 查询知识图谱以获取目标上下文（13-42 个 Token）。在影响分析中节省 98% 的 Token。
安装
一行命令安装（推荐）
curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- <target>支持的目标：
目标 | AI 工具 | 自动安装 |
| OpenCode AI | 二进制 + MCP + 插件 + 技能 + AGENTS.md |
| Cursor AI | 二进制 + MCP + 技能 + AGENTS.md + 会话钩子 |
| Claude Code | 二进制 + MCP + 插件 + 技能 + CLAUDE.md + 会话钩子 |
| Gemini CLI | 二进制 + MCP + 技能 + GEMINI.md |
| Kilo Code | 二进制 + MCP + 技能 + AGENTS.md |
| Google Antigravity | 二进制 + MCP + 技能 + GEMINI.md |
示例：
curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- cursor
curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- claude通过 Cargo 安装或从源码构建
cargo install leankg && leankg --versiongit clone https://github.com/FreePeak/LeanKG.git && cd LeanKG && cargo build --release快速入门
leankg init # Initialize LeanKG in your project
leankg index ./src # Index your codebase
leankg watch ./src # Auto-index on file changes
leankg impact src/main.rs --depth 3 # Calculate blast radius
leankg status # Check index status
leankg metrics # View token savings
leankg web # Start Web UI at http://localhost:8080查看 docs/cli-reference.md 获取所有命令。
亮点
自动初始化 -- 安装脚本自动配置 MCP、规则、技能和钩子
自动触发 -- 会话钩子将 LeanKG 上下文注入到每个 AI 工具会话中
Token 简洁 -- 每次查询 13-42 个 Token，而完整代码库扫描需要 10,000+ 个 Token
节省 Token -- 在影响分析中最高可减少 98% 的 Token 使用量
影响范围 -- 在进行更改前计算影响半径
依赖图 -- 使用
IMPORTS、CALLS、TESTED_BY边构建调用图MCP 服务器 -- 通过 MCP 协议暴露图谱，以便 AI 工具集成
多语言 -- 使用 tree-sitter 索引 Go、TypeScript、Python、Rust、Java、Kotlin
查看 docs/architecture.md 了解系统设计和数据模型详情。
支持的 AI 工具
工具 | 自动设置 | 会话钩子 | 插件 |
Cursor | 是 | session-start | - |
Claude Code | 是 | session-start | 是 |
OpenCode | 是 | - | 是 |
Kilo Code | 是 | - | - |
Gemini CLI | 是 | - | - |
Google Antigravity | 是 | - | - |
Codex | 是 | - | - |
注意： Cursor 需要按项目安装。AI 功能基于每个工作区运行，因此 LeanKG 应安装在每个需要 AI 上下文注入的项目目录中。
查看 docs/agentic-instructions.md 了解详细设置和自动触发行为。
Web UI
leankg web --port 9000使用力导向布局、WebGL 渲染和社区聚类可视化你的知识图谱。
查看 docs/web-ui.md 了解更多功能。
上下文指标
跟踪 Token 节省情况以了解 LeanKG 的效率。
leankg metrics --json # View with JSON output
leankg metrics --since 7d # Filter by time
leankg metrics --tool search_code # Filter by tool查看 docs/metrics.md 获取模式和示例。
更新
# Check current version
leankg version
# Update LeanKG binary via install script
curl -fsSL https://raw.githubusercontent.com/FreePeak/LeanKG/main/scripts/install.sh | bash -s -- update在线演示
无需安装即可试用 LeanKG：https://leankg.onrender.com
文档
文档 | 描述 |
所有 CLI 命令 | |
MCP 工具参考 | |
AI 工具设置与自动触发 | |
系统设计、数据模型 | |
Web UI 功能 | |
指标模式与示例 | |
性能基准测试 | |
功能规划 | |
技术栈与结构 |
要求
Rust 1.70+
macOS 或 Linux
许可证
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/FreePeak/LeanKG'
If you have feedback or need assistance with the MCP directory API, please join our Discord server