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标识符进行完整的可追溯性

📄 许可证

文档中未提及相关内容，故跳过该章节。