code-context-graph は何をしますか？
AIコーディングエージェントのためのベクトル不要なコード検索 — ビジネス意図（@intent、@domainRule）でコードを検索、MCP経由でMSA向けに構築。
概要
code-context-graphは、AIエージェント（Claude Code、Cursor、Codexなど）が大規模なコードベースから関連するコード断片を効率的に見つけるためのツールです。従来のベクトル埋め込み検索とは異なり、ビジネス意図に基づいたタグ付けシステムを利用するため、セットアップが簡単でリソース消費が少なくなります。
特徴
- ベクトル不要: 埋め込みモデルやベクトルデータベースが不要で、導入と実行が軽量。
- ビジネス意図検索:
@intentや@domainRuleタグを使用して、コードの機能目的やドメインルールで検索。 - MSA対応: マイクロサービス環境向けに最適化され、サービス間のコンテキストを効率的に取得。
- MCP統合: Model Context Protocol（MCP）を介してAIエージェントとシームレスに連携。
使用方法
前提条件
- Node.js 18以上
- MCP対応のAIエージェント（Claude Code、Cursor、Codexなど）
インストール
npm install -g code-context-graph
MCP設定
AIエージェントの設定ファイル（例: claude_code_config.json）に以下を追加します：
{
"mcpServers": {
"code-context-graph": {
"command": "npx",
"args": ["code-context-graph"],
"env": {
"CODE_CONTEXT_GRAPH_DIR": "/path/to/your/project"
}
}
}
}
コードへのタグ付け
コードファイルに@intentタグと@domainRuleタグをコメントとして追加します：
// @intent ユーザー認証処理
// @domainRule パスワードは8文字以上必須
function authenticateUser(password) {
// ...
}
エージェントからの検索
エージェントが以下のようにクエリを実行します：
/search-code @intent ユーザー認証
動作の仕組み
- タグの抽出: コードベースをスキャンし、
@intentと@domainRuleのコメントを解析。 - グラフ構造の構築: タグとコード断片の関係をグラフデータベースに保存。
- クエリ応答: エージェントからの検索要求に対して、関連するコード断片のリストを返却。
環境変数
| 変数名 | 説明 |
|---|---|
CODE_CONTEXT_GRAPH_DIR | 検索対象のプロジェクトディレクトリ |
CODE_CONTEXT_GRAPH_PORT | MCPサーバーのポート番号（デフォルト: 3000） |
ライセンス
MIT