🤖 AI Code Review MCP Server

🤖 AI 代码审查 MCP 服务

用于 AI 代码审查和质量管理的 MCP（Model Context Protocol）服务。

✨ 主要功能

🔍 AI 代码审查

• 按提交类型分析：针对 feat、fix、refactor 等类型进行定制审查
• 计算质量分数：从复杂度、可维护性、安全性等多个角度进行评估
• 安全漏洞检查：自动检测潜在的安全问题
• 性能影响分析：评估对性能的影响

📋 集成审查系统

• 按提交类型分析：针对每种提交类型进行单独分析
• 集成审查检查：一次性查看所有分析结果
• 提供检查清单：检查容易遗漏的审查要点
• Markdown 报告：以 Markdown 格式生成综合审查结果

🎯 审查指南

• 按类型提供指南：针对提交类型生成相应的审查指南
• 最佳实践：提供各类型的建议
• 注意事项：提前提示常见问题

🚀 快速开始

1. 配置环境

# 저장소 클론
git clone <repository-url>
cd ai-review-mcp-server

# 의존성 설치
npm install

# 환경 변수 설정
cp .env.example .env

2. 配置环境变量

# Claude API 설정
CLAUDE_API_KEY=sk-ant-api-03-xxx

# GitHub 설정  
GITHUB_TOKEN=ghp_xxx
GITHUB_WEBHOOK_SECRET=your-webhook-secret

# 서버 설정
PORT=3001
NODE_ENV=development

3. 启动服务

# 개발 모드 (자동 재시작)
npm run dev

# 프로덕션 모드
npm run build
npm start

4. 访问 Web UI

在浏览器中访问 http://localhost:3001，即可使用 Web UI。

🖥️ Web UI 使用方法

PR 分析

1. 输入存储库：按 owner/repo 格式输入
2. 输入 PR 编号：输入要分析的 PR 编号
3. 选择提交类型：选择适当的提交类型
4. 运行分析：点击“PR 分析”按钮

集成审查检查

1. PR 分析完成后，点击“集成审查检查”按钮
2. 在模态框中查看按提交类型划分的分析结果
3. 查看集成审查指南
4. 使用检查清单进行审查

🔧 API 端点

HTTP API

# PR 분석
POST /analyze
{
  "repo": "owner/repo",
  "pr_number": 123,
  "commit_type": "feat",
  "enable_split": true,
  "deep_analysis": false
}

# 리뷰 가이드 생성
POST /review-guide
{
  "commit_type": "feat",
  "file_changes": ["src/component.tsx"]
}

# 품질 점수 계산
POST /quality-score
{
  "changes": [...],
  "metrics": {}
}

# 헬스 체크
GET /health

MCP 工具

// MCP 클라이언트에서 사용
{
  "method": "tools/call",
  "params": {
    "name": "analyze_pr",
    "arguments": {
      "repo": "owner/repo",
      "pr_number": 123,
      "commit_type": "feat"
    }
  }
}

🐳 使用 Docker

构建并运行 Docker

# Docker 이미지 빌드
npm run docker:build

# Docker 컨테이너 실행
npm run docker:run

Docker Compose

# 전체 스택 실행
docker-compose up -d

# 로그 확인
docker-compose logs -f ai-review

⚙️ 配置 GitHub Webhook

1. GitHub 存储库 → Settings → Webhooks
2. Payload URL：https://your-domain.com/webhook
3. Content type：application/json
4. Events：Pull requests
5. Secret：.env 中的 GITHUB_WEBHOOK_SECRET 值

📊 响应格式

PR 分析响应

{
  "success": true,
  "pr_number": 123,
  "repo": "owner/repo",
  "analyzed_at": "2024-06-04T10:30:00Z",
  "by_commit_type": {
    "feat": {
      "analysis": {
        "summary": "새로운 기능 분석 요약",
        "quality_score": 87,
        "review_points": ["...", "..."],
        "suggestions": ["...", "..."],
        "security_concerns": ["..."],
        "performance_impact": ["..."]
      },
      "guide": {
        "title": "새로운 기능 개발 리뷰 가이드",
        "checklist": ["...", "..."],
        "focus_areas": ["...", "..."],
        "common_issues": ["...", "..."],
        "best_practices": ["...", "..."]
      }
    }
  },
  "summary_review": {
    "markdown": "# 📋 PR 종합 리뷰\n\n..."
  }
}

🛠️ 自定义

修改审查模板

可以在 src/handlers/claude-client.ts 中修改提示词模板：

private getCommitTypeGuidelines(commitType: string): string {
  // 커밋 타입별 가이드라인 커스터마이징
}

调整质量分数标准

可以在 src/handlers/pr-analyzer.ts 中修改质量分数计算逻辑：

async calculateQualityScore(changes: any[], metrics: any = {}) {
  // 품질 점수 계산 로직 커스터마이징
}

🚨 故障排除

常见问题

1. CLAUDE_API_KEY 错误

   • 确认 Claude API 密钥是否正确
   • 确认密钥的权限和余额

2. GITHUB_TOKEN 错误

   • 确认 GitHub Personal Access Token
   • 确认是否拥有 repo 权限

3. PR 分析失败

   • 确认 PR 是否存在
   • 确认是否有权访问存储库

查看日志

# 개발 모드에서 상세 로그 확인
DEBUG=* npm run dev

# 프로덕션 로그 확인
docker-compose logs ai-review

📝 参与贡献

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

📄 许可证

MIT 许可证——详情请参阅 LICENSE 文件。

🙏 致谢

• Anthropic - 提供 Claude API
• Model Context Protocol - MCP 框架
• GitHub - 提供 GitHub API

---

由 김정규 用 ❤️ 制作