Xala MCP Server

MCP开发工作流服务器

一个全面的模型上下文协议（MCP）服务器，作为组织开发团队的智能开发工作流编排器和代码质量把关人。

特性

核心能力

• 完全支持MCP协议：基于HTTP/WebSocket的JSON-RPC 2.0，包含资源、工具和提示
• 开发工作流编排：从需求到实施的自动化规范生成
• 质量把关系统：通过可配置的规则执行严格的开发标准
• 多项目支持：管理具有不同配置的多个项目
• 可扩展架构：易于添加新工具、资源和提示

规范管理系统

三阶段工作流程

1. 需求分析：使用EARS格式将用户提示转换为结构化需求
2. 技术设计：生成架构决策、接口和数据流图
3. 实施计划：将工作分解为具有依赖关系的细粒度、有序的任务

质量规则引擎

五个规则类别

1. TypeScript合规性：严格的类型安全，显式返回类型，无 any 类型
2. 代码质量：设计令牌合规性、组件架构、状态管理模式
3. 可访问性和合规性：WCAG 2.2 AAA、国际化、GDPR合规性
4. 成套系统：干净的架构、依赖关系管理、文档标准
5. 业务逻辑：错误处理模式、安全标准、测试要求

自动挂钩系统

• 文件更改挂钩：自动生成测试，更新文档
• 质量保证挂钩：提交前验证、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 start

2.配置

创建一个 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: true

3.项目配置

在中创建项目配置 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

贡献

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件