aceflow-mcp-server

# AceFlow - OpenAPI Contract Management CLI > 轻量级的前后端协作契约管理工具，基于 OpenAPI 规范的 Contract-First 开发流程 [](tests/) [](https://www.python.org) [](LICENSE) ## 🎯 核心特性 - **📄 契约生成** - 从 Spring Boot OpenAPI Spec 生成过滤后的契约文件 - **🔄 Git 集成** - 自动推送/拉取契约到 Git 仓库 - **🤖 智能补全** - 基于规则自动添加 OpenAPI 示例值 - **🎭 Mock Server** - 基于 Prism 的 Mock API 服务器管理 - **📧 邮件通知** - 契约更新自动通知开发团队 - **⚙️ 配置管理** - 简单的 YAML 配置文件管理 ## 🚀 快速开始 ### 安装 ```bash # 克隆仓库 git clone https://github.com/aceflow-pateoas/aceflow-ai.git cd aceflow-ai/aceflow-mcp-server # 安装依赖 pip install -e . # 安装 Prism CLI (用于 Mock Server) npm install -g @stoplight/prism-cli ``` ### 初始化项目 ```bash # 交互式初始化配置 aceflow init # 非交互式初始化 aceflow init \ --project-name "My API Project" \ --openapi-url "http://localhost:8080/v3/api-docs" \ --repo-url "git@github.com:your-org/contracts.git" \ --non-interactive ``` ### 基本工作流 #### 1. 后端开发者：生成并推送契约 ```bash # 添加功能配置 aceflow feature add \ --name user-management \ --api-filter "/api/user/" \ --filter-type prefix \ --description "User management APIs" \ --dev-team "frontend@example.com,backend@example.com" \ --non-interactive # 生成契约 aceflow contract generate --feature user-management # 推送到 Git 仓库（自动发送邮件通知） aceflow contract push --feature user-management ``` #### 2. 前端开发者：拉取契约并启动 Mock ```bash # 拉取最新契约 aceflow contract pull --feature user-management # 启动 Mock Server aceflow mock start --feature user-management --port 4010 # 前端开发使用 Mock API curl http://localhost:4010/api/user/login # 停止 Mock Server aceflow mock stop --port 4010 ``` ## 🤖 MCP Tools for AI-Driven Workflow AceFlow 现已提供 **13 个 MCP Tools**，支持完整的 AI 驱动 Contract-First 开发工作流！ ### 核心工作流工具 (4 个) - `aceflow_init` - 初始化项目基础结构 - `aceflow_stage` - 管理工作流阶段 - `aceflow_validate` - 验证项目合规性 - `aceflow_template` - 管理工作流…