Advanced Code Analysis MCP Server

高级代码分析 MCP 服务

🚀 结合知识图谱与 AI 洞察的高级代码分析系统

一款复杂的 MCP 服务，结合 Neo4j 知识图谱、AI 驱动的分析和高级静态分析，适用于大型代码项目。

✨ 主要功能

• 🧠 AI 驱动的分析，借助 GPT-4/Claude 提供高级洞察
• 📊 高级知识图谱，借助 Neo4j 建立复杂关系
• 🔍 自然语言查询，无需学习
• 🏗️ 深度架构分析
• ⚡ 并行处理，适用于大型项目
• 🛡️ 自动化安全分析
• 📈 全面的质量指标

🎯 性能目标

• 在 30 分钟内处理最多 1,000 万行代码
• 10 个以上并发分析任务
• 大多数查询的响应时间 < 1 秒
• 实体和关系检测的准确率超过 95%

🚀 快速设置

系统要求

• Node.js 18+
• Docker 和 Docker Compose
• 8GB+ RAM
• 100GB+ 磁盘空间

使用 Docker 设置

# Clone the project
git clone https://github.com/ItamarZand88/advanced-code-analysis-mcp.git
cd advanced-code-analysis-mcp

# Setup environment configuration
cp .env.example .env
# Edit .env with your settings

# Run the system
docker-compose up -d

# Check status
curl http://localhost:3000/health

本地安装

# Install dependencies
npm install

# Build the project
npm run build

# Run in development
npm run dev

# Run in production
npm start

📖 基本用法

仓库分析

import { MCPServer } from './dist/index.js';

const server = new MCPServer();

// Start analysis
const result = await server.analyzeRepository(
  'https://github.com/microsoft/vscode',
  'main',
  {
    includeTests: true,
    enableAIInsights: true,
    parallelWorkers: 8
  }
);

console.log(`Job ID: ${result.jobId}`);

自然语言查询

// Example queries
const queries = [
  'Show me the most complex functions in the system',
  'Find circular dependencies',
  'Which files are missing tests?',
  'Show me potential security vulnerabilities',
  'What are the main architectural patterns?'
];

for (const query of queries) {
  const result = await server.queryGraph(query, graphId);
  console.log(result.interpretation);
}

高级 API

// Complexity analysis
const complexity = await server.getComplexityAnalysis(graphId);

// Dependency analysis
const dependencies = await server.getDependencyAnalysis(graphId);

// Quality assessment
const quality = await server.getQualityMetrics(graphId);

// Security analysis
const security = await server.getSecurityAnalysis(graphId);

🔧 高级配置

分析设置

// .env
MAX_CONCURRENT_ANALYSES=10
PARALLEL_WORKERS=16
MAX_FILE_SIZE=50485760  // 50MB
INCLUDE_TESTS=true
ENABLE_AI_INSIGHTS=true

AI 配置

AI_PROVIDER=openai
AI_MODEL=gpt-4
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here

Neo4j 配置

NEO4J_URI=bolt://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=secure_password
NEO4J_DATABASE=codeanalysis

📊 监控与指标

• Neo4j 浏览器：http://localhost:7474
• Grafana 仪表板：http://localhost:3001 (admin/admin)
• Prometheus 指标：http://localhost:9091
• 健康检查：http://localhost:3000/health

🎨 使用示例

1. 企业代码审计

Analyze our main system for security issues and code smells

2. 开发者入职

Show me the core components and how they interact

3. 重构规划

Find the most tightly coupled components and suggest where to break dependencies

4. 性能分析

Find bottlenecks and inefficient algorithms

🛠️ 开发

运行测试

npm test
npm run test:watch
npm run test:coverage

代码质量与 Lint 检查

npm run lint
npm run lint:fix
npm run format

生产构建

npm run build
npm run docker:build

📚 更多文档

• 📖 API 文档
• 🏗️ 架构指南
• 🔧 配置参考
• 🚀 部署指南
• 🤝 贡献指南

🤝 参与贡献

1. Fork 项目
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

📄 许可证

本项目根据 MIT License 发布。详情请参阅 LICENSE。

🙋‍♂️ 支持

• 📧 邮箱：[email protected]
• 💬 Discord：社区服务器
• 🐛 问题：GitHub Issues
• 📖 文档：完整文档

---

⭐ 如果这个项目对你有帮助，别忘了给它点星！