Code Graph Rag MCP

🚀 代碼圖RAG MCP內存庫

代碼圖RAG MCP是一個先進的模型上下文協議（MCP）服務器，它能夠通過全面的語義分析能力為代碼庫創建智能圖表示。它提供了13種專門的分析工具，用於多語言代碼理解、關係映射和語義搜索。

🚀 快速開始

項目上下文導航

• - 技術能力和MCP集成
• - 架構、代理和依賴項
• - 活躍的開發看板和優先級
• - 多代理協調和治理框架

開發流程

• - 由指揮者驅動的開發過程
• - 多代理測試協調
• - NPM發佈和分發
• - 多代理系統工作流

架構與模式

• - MCP架構的ADR文檔
• - 多代理協調模式
• - 實體提取和關係映射
• - SQLite圖存儲設計
• - TASK-XXX生命週期和協調

實施指南

• - 完整的13種工具的API文檔
• - Claude桌面版的設置和配置
• - sqlite-vec和硬件加速
• - 分析多個項目
• - 向量搜索和人工智能驅動的代碼理解
• - 構建和擴展代理

故障排除與操作

• - UltraFink/UltraThink集成修復
• - 硬件優化和擴展
• - SQLite、遷移和圖查詢
• - 多代理系統調試

操作日誌

• - 開發會話日誌和代理協調
  • TASK-XXX.json - 帶有代理工作流的結構化執行日誌
  • TASK-XXX.log - 詳細的逐步開發跟蹤
  • [組件]_development.log - 特定組件的開發日誌
  • mcp-integration-*.log - MCP協議通信日誌

人工智能代理快速入門

上下文優先級

1. 代理治理：根據AGENTS.md，對於複雜任務始終使用指揮者代理。
2. 當前重點：查看當前任務以瞭解即時優先級。
3. 技術上下文：查看技術棧以瞭解MCP架構約束。
4. 架構：理解ADR文檔以瞭解核心設計決策。

開發指南

• 多代理協調：對於所有複雜任務（>2步）使用指揮者代理。
• MCP開發：遵循MCP工具參考進行工具集成。
• 代碼分析：遵循代碼分析模式進行實體提取。
• 性能：遵循性能優化進行sqlite-vec集成。

關鍵約束

• Node.js 18+ - 最低運行時版本
• TypeScript ESM - 嚴格的ES模塊架構
• 多代理系統 - 需要指揮者編排
• MCP協議 - JSON-RPC 2.0通信標準
• SQLite + 向量擴展 - 帶有語義搜索的圖存儲

✨ 主要特性

MCP工具組合（13種工具）

• ✅ index - 支持增量處理的多代理解析和索引
• ✅ list_file_entities - 使用Tree-sitter解析器進行實體提取
• ✅ list_entity_relationships - 圖遍歷和關係分析
• ✅ query - 自然語言和結構化查詢
• ✅ semantic_search - 基於向量的自然語言代碼搜索
• ✅ find_similar_code - 使用語義分析進行代碼相似度檢測
• ✅ analyze_code_impact - 代碼更改的影響分析
• ✅ detect_code_clones - 跨代碼庫的重複代碼檢測
• ✅ suggest_refactoring - 人工智能驅動的重構建議
• ✅ cross_language_search - 多語言代碼模式搜索
• ✅ analyze_hotspots - 代碼熱點分析（複雜性、更改、耦合）
• ✅ find_related_concepts - 概念關係發現
• ✅ get_graph/get_graph_stats - 直接訪問圖數據庫

多代理架構

• ✅ ConductorOrchestrator - 任務協調和5種方法的提案生成
• ✅ ParserAgent - 基於高性能Tree-sitter的解析（每秒處理100+文件）
• ✅ IndexerAgent - 基於SQLite的圖存儲和索引
• ✅ QueryAgent - 圖遍歷和關係查詢
• ✅ SemanticAgent - 向量搜索和語義分析
• ✅ DevAgent - 開發協調和實現
• ✅ DoraAgent - 研究和發現操作

性能成就

• ✅ 比原生Claude工具快5.5倍
• ✅ 每秒解析吞吐量超過100個文件
• ✅ 簡單操作的查詢響應時間小於100ms
• ✅ 大型倉庫的內存使用小於1GB
• ✅ 通過sqlite-vec擴展實現硬件加速

語言支持

• ✅ TypeScript/JavaScript - 完整的AST解析和分析
• ✅ Python - 具有全面實體提取的增強功能
• ✅ C/C++ - 通過Tree-sitter提供原生支持
• ✅ Java - 企業應用程序分析
• ✅ Go - 現代語言支持
• ✅ Rust - 系統編程語言
• ✅ 多語言 - 跨語言關係檢測

🎯 當前開發重點

近期優先事項

1. 內存庫集成 - 為MCP開發進行系統的知識管理
2. 增強Python支持 - 高級特定語言分析功能
3. 代理協調優化 - 改進多代理任務委託
4. 向量搜索增強 - 更好的語義分析和代碼理解
5. 跨語言關係 - 增強多語言代碼庫分析

架構增強

• 指揮者代理治理 - 所有複雜開發任務都必須使用
• 專用代理工作流 - 針對不同任務類型的明確委託模式
• TASK-XXX跟蹤 - 全面的開發生命週期管理
• ADR文檔 - MCP設計決策的架構決策記錄

集成特性

• Claude桌面集成 - 無縫的MCP協議通信
• NPM分發 - 全局安裝和特定項目使用
• sqlite-vec集成 - 硬件加速的向量操作
• 內存庫模式 - 為人工智能輔助開發進行系統的知識捕獲

🔧 開發命令

構建與打包

# 構建TypeScript
bun run tsup

# 為NPM打包
make package

# 代碼檢查和格式化
npx biome check --apply .

測試與驗證

# 運行測試套件
npm test

# 測試MCP集成
./test-tools.sh

# 性能測試
./test-correct-tools.sh

代理協調

# 對於複雜任務始終使用指揮者代理
# 示例：複雜功能開發
use agent conductor
  implement advanced semantic search with vector optimization

# 示例：研究和文檔編寫
use agent dora
  research latest Tree-sitter language support for enhanced parsing

🔧 維護說明

內存庫更新

• 頻率：在每個開發會話期間更新
• 責任：遵循指揮者治理的人工智能代理
• 驗證：在代理協調期間進行自動檢查

知識捕獲

• 架構決策：patterns/architectural_decisions.md中的ADR-XXX文檔
• 代理工作流：patterns/agent_delegation.md中的多代理協調模式
• 開發流程：workflows/目錄中的MCP特定工作流
• 任務跟蹤：current_tasks.md中的TASK-XXX生命週期管理
• 技術知識：guides/目錄中的特定組件指南

操作日誌結構

• logs_llm/TASK-XXX.json：帶有代理工作流的結構化執行日誌
• logs_llm/TASK-XXX.log：人類可讀的代理協調跟蹤
• logs_llm/[組件]_development.log：特定組件的開發日誌
• logs_llm/mcp-integration-*.log：MCP協議通信調試
• 集成：操作日誌支持戰略內存庫知識

代理協調

• 指揮者編排：所有複雜任務（>2步）都需要指揮者代理
• 專用委託：將解析/索引工作委託給專用代理
• 研究協調：使用Dora代理進行全面研究和文檔編寫
• 開發協調：使用DevAgent進行實現工作
• 任務驗證：使用TASK-XXX標識符進行完整的可追溯性

📄 許可證

文檔中未提及相關內容，故跳過該章節。