LeanKG は何をしますか？
コードベースをローカルナレッジグラフにインデックスし、直接MCPサーバー接続を通じてAIコーディングツールに正確なコンテキストを提供します。
概要
LeanKGは、コードベースの構造と意味を理解するための軽量ナレッジグラフを構築します。これにより、AIエージェントはプロジェクト全体のコンテキストを把握し、より正確なコード補完、リファクタリング、および質問応答を実行できます。
特徴
- ローカルファースト: データはすべてローカルに保存され、クラウドサービスに依存しません。
- MCP互換: Model Context Protocol (MCP) サーバーとして動作し、対応するすべてのAIツールと連携できます。
- 高速インデックス: コードベースの変更をリアルタイムで追跡し、ナレッジグラフを効率的に更新します。
- 多言語対応: Python、JavaScript、TypeScript、Go、Rustなど、主要なプログラミング言語をサポートします。
インストール
# npmを使用する場合
npm install -g leankg
# または、pipを使用する場合
pip install leankg
使用方法
- プロジェクトのルートディレクトリで以下のコマンドを実行します:
leankg init
- MCPサーバーを起動します:
leankg serve
- AIコーディングツールでMCPサーバーに接続します。例えば、Claude Codeの設定ファイルに以下を追加します:
{
"mcpServers": {
"leankg": {
"command": "leankg",
"args": ["serve"],
"env": {
"LEANKG_PORT": "8080"
}
}
}
}
設定
環境変数または設定ファイルで以下のオプションを構成できます:
| 変数名 | 説明 | デフォルト値 |
|---|---|---|
LEANKG_PORT | MCPサーバーのポート | 8080 |
LEANKG_CACHE_DIR | キャッシュディレクトリ | ~/.leankg/cache |
LEANKG_MAX_DEPTH | インデックスの最大深度 | 10 |
開発者向け情報
アーキテクチャ
LeanKGは以下の主要コンポーネントで構成されています:
- パーサー: コードファイルを解析し、AST（抽象構文木）を生成します。
- グラフビルダー: ASTからエンティティや関係を抽出し、ナレッジグラフを構築します。
- クエリエンジン: 自然言語や構造化クエリを受け取り、グラフから関連情報を取得します。
- MCPサーバー: 外部AIツールとの通信を管理します。
拡張方法
新しい言語のサポートを追加するには、parsers/ ディレクトリに新しいパーサーモジュールを作成してください。詳細はドキュメントを参照してください。
ライセンス
MIT License
貢献
バグ報告や機能リクエストは、GitHubのIssuesまでお願いします。