MCP开发工作流服务器
一个全面的模型上下文协议（MCP）服务器，作为组织开发团队的智能开发工作流编排器和代码质量把关人。
特性
核心能力
- 完全支持MCP协议：基于HTTP/WebSocket的JSON-RPC 2.0，包含资源、工具和提示
- 开发工作流编排：从需求到实施的自动化规范生成
- 质量把关系统：通过可配置的规则执行严格的开发标准
- 多项目支持：管理具有不同配置的多个项目
- 可扩展架构：易于添加新工具、资源和提示
规范管理系统
三阶段工作流程
- 需求分析：使用EARS格式将用户提示转换为结构化需求
- 技术设计：生成架构决策、接口和数据流图
- 实施计划：将工作分解为具有依赖关系的细粒度、有序的任务
质量规则引擎
五个规则类别
- TypeScript合规性：严格的类型安全，显式返回类型，无
any类型 - 代码质量：设计令牌合规性、组件架构、状态管理模式
- 可访问性和合规性：WCAG 2.2 AAA、国际化、GDPR合规性
- 成套系统：干净的架构、依赖关系管理、文档标准
- 业务逻辑：错误处理模式、安全标准、测试要求
自动挂钩系统
- 文件更改挂钩：自动生成测试，更新文档
- 质量保证挂钩：提交前验证、CI/CD集成
- 工作流挂钩：任务完成跟踪、规范更新
安装
npm install @organization/mcp-workflow-server快速开始
1.基本设置
# Clone and install
git clone
cd mcp-workflow-server
npm install
# Build the project
npm run build
# Start the server
npm start2.配置
创建一个 config/server.yaml 文件：
server:
port: 3000
host: localhost
protocol: both # http, ws, or both
mcp:
capabilities:
resources: true
tools: true
prompts: true
quality:
enableGatekeeper: true
blockOnViolations: true
autoFix: false
workflow:
autoGenerateSpecs: true
requireApproval: true3.项目配置
在中创建项目配置 config/projects/my-project.yaml:
projectId: my-project
name: My React Application
rootPath: /path/to/project
rules:
typescript:
strictTypes: true
noAnyTypes: true
maxFileLines: 300
codeQuality:
enforceDesignTokens: true
componentStructure:
maxComplexity: 10
thresholds:
codeQuality:
typeSafetyScore: 95
testCoverage:
unit: 80
integration: 70用法
与Claude Desktop一起使用
添加到您的Claude Desktop配置中：
{
"mcpServers": {
"workflow-server": {
"command": "node",
"args": ["/path/to/mcp-workflow-server/dist/index.js"],
"env": {
"NODE_ENV": "production"
}
}
}
}可用资源
project-analysis：全面的项目指标和分析codebase-structure：代码库组织的可视化表示quality-report：当前的质量违规和指标specification-status：需求、设计和任务的状态workflow-templates：可重复使用的工作流模板task-dependencies：任务依赖关系图compliance-status：符合标准（WCAG、GDPR等）performance-metrics：绩效预算和指标
可用工具
analyze-codebase：深入分析代码库质量validate-component：根据标准验证React组件check-accessibility：WCAG合规性检查verify-types：TypeScript验证generate-specification：根据用户提示生成规格create-tasks：将需求分解为任务update-documentation：将文档与代码同步enforce-standards：应用质量标准
可用提示
component-review：查看React组件architecture-guidance：获取架构建议accessibility-review：审查无障碍合规性performance-optimization：性能改进建议specification-generation：生成项目规范task-breakdown：将功能分解为任务quality-review：全面质量审查compliance-check：检查监管合规性
API示例
HTTP API
# List available resources
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"resources/list"}'
# Generate specifications
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "generate-specification",
"arguments": {
"prompt": "Build a user authentication system",
"projectId": "my-project",
"phase": "all"
}
}
}'WebSocket API
const ws = new WebSocket('ws://localhost:3001');
ws.on('open', () => {
ws.send(JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/list'
}));
});
ws.on('message', (data) => {
const response = JSON.parse(data);
console.log(response);
});建筑
mcp-workflow-server/
├── src/
│ ├── core/ # Core MCP server implementation
│ ├── resources/ # MCP resources
│ ├── tools/ # MCP tools
│ ├── prompts/ # MCP prompts
│ ├── rules/ # Quality rule engine
│ ├── metrics/ # Metrics collection
│ ├── hooks/ # Automation hooks
│ ├── config/ # Configuration management
│ ├── utils/ # Utilities
│ └── types/ # TypeScript types
├── config/ # Configuration files
├── tests/ # Test suite
└── docs/ # Documentation发展
# Run in development mode
npm run dev
# Run tests
npm test
# Run linting
npm run lint
# Type checking
npm run typecheck贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件