审核人MCP
一种MCP（模型上下文协议）服务，提供人工智能驱动的开发工作流工具。它支持多个AI提供商（OpenAI和Ollama），并为规范生成、代码审查和项目管理提供标准化工具。
特性
- 规格生成：根据提示创建详细的技术规范
- 规范审查：审查规范的完整性并提供关键反馈
- 代码审查：分析代码更改，重点关注安全性、性能、风格或逻辑
- 测试运行器：使用LLM友好的格式化输出执行测试
- 过梁：使用结构化输出格式运行过梁
- 可插拔AI提供商：支持OpenAI和Ollama（本地模型）
安装
npm install
npm run build配置
环境变量
创建一个 .env 文件基于 .env.example:
# AI Provider Configuration
AI_PROVIDER=openai # Options: openai, ollama
# OpenAI Configuration
OPENAI_API_KEY=your_api_key_here
OPENAI_MODEL=o1-preview
# Ollama Configuration (for local models)
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama2项目配置
创建一个 .reviewer.json 项目根目录中的文件以自定义命令：
{
"testCommand": "npm test",
"lintCommand": "npm run lint",
"buildCommand": "npm run build",
"aiProvider": "ollama",
"ollamaModel": "codellama"
}与Claude Desktop一起使用
将以下内容添加到您的Claude Desktop配置中：
{
"mcpServers": {
"reviewer": {
"command": "node",
"args": ["/path/to/reviewer-mcp/dist/index.js"],
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
}
}与Olama一起使用
- 安装Ollama：https://ollama.ai
- 拉一个模型：
ollama pull llama2或ollama pull codellama - 集
AI_PROVIDER=ollama在你的.env文件 - 该服务将使用您本地的Ollama实例
可用工具
generate_spec
生成技术规范文件。
参数：
prompt（必填）：描述要生成什么规范context（可选）：附加上下文或要求format（可选）：输出格式-“markdown”或“结构化”
review_spec
审查规范的完整性，并提供关键反馈。
参数：
spec（必填）：待审查的规范文件focusAreas（可选）：集中审查的一系列具体领域
review_code
审查代码更改并提供反馈。
参数：
diff（必填）：Git差异或代码更改需要审查context（可选）：有关更改的上下文reviewType（可选）：审查类型-“安全”、“性能”、“风格”、“逻辑”或“全部”
run_tests
为项目运行标准化测试。
参数：
testCommand（可选）：要运行的测试命令（默认为配置的命令）pattern（可选）：要匹配的测试文件模式watch（可选）：在监视模式下运行测试
run_linter
为项目运行标准化过梁。
参数：
lintCommand（可选）：要运行的Lint命令（默认为配置的命令）fix（可选）：尝试自动修复问题files（可选）：要lint的特定文件数组
发展
# Run in development mode
npm run dev
# Run tests
npm test
# Run unit tests only
npm run test:unit
# Run integration tests (requires Ollama)
npm run test:integration
# Type checking
npm run typecheck
# Linting
npm run lint端到端测试
该项目包括一个全面的e2e测试，使用真实的Ollama实例验证整个工作流程：
- 安装并启动Ollama：https://ollama.ai
- 拉一个模型：
ollama pull llama2 - 运行测试：
npm run test:e2e
e2e测试表明：
- 规格生成
- 规范审查
- 代码创建
- 代码审查
- 代码检查
- 测试执行
所有这些都使用来自本地Ollama实例的真实AI响应。
许可证
麻省理工学院