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
endLeanKG 미사용 시: AI가 전체 코드베이스를 스캔합니다 (~10,000개 이상의 토큰). LeanKG 사용 시: AI가 지식 그래프를 쿼리하여 타겟팅된 컨텍스트를 가져옵니다 (13-42 토큰). 영향 분석 시 토큰 98% 절감.
설치
한 줄 설치 (권장)
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 -- claudeCargo를 통한 설치 또는 소스에서 빌드
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, 규칙, 스킬 및 훅을 자동으로 구성합니다.
자동 트리거 -- 세션 훅이 모든 AI 도구 세션에 LeanKG 컨텍스트를 주입합니다.
토큰 효율성 -- 전체 코드베이스 스캔 시 10,000개 이상의 토큰이 필요한 반면, 쿼리당 13-42 토큰만 사용합니다.
토큰 절감 -- 영향 분석 시 최대 98%의 토큰을 절감합니다.
영향 범위 -- 변경 사항을 적용하기 전에 영향 범위를 계산합니다.
의존성 그래프 --
IMPORTS,CALLS,TESTED_BY엣지를 사용하여 호출 그래프를 구축합니다.MCP 서버 -- AI 도구 통합을 위해 MCP 프로토콜을 통해 그래프를 노출합니다.
다중 언어 -- 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 기능은 워크스페이스 단위로 작동하므로, AI 컨텍스트 주입을 원하는 각 프로젝트 디렉토리에 LeanKG를 설치해야 합니다.
자세한 설정 및 자동 트리거 동작은 docs/agentic-instructions.md를 참조하세요.
웹 UI
leankg web --port 9000힘 지향 레이아웃, WebGL 렌더링 및 커뮤니티 클러스터링을 통해 지식 그래프를 시각화하세요.
더 많은 기능은 docs/web-ui.md를 참조하세요.
컨텍스트 메트릭
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 도구 설정 및 자동 트리거 | |
시스템 설계, 데이터 모델 | |
웹 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