AgileBuilder logoAgileBuilder
返回文档

AI 集成 (MCP)

让 AI 按统一规范创建项目

通过 MCP (Model Context Protocol) 协议，让 AI 工具基于你的模板体系生成项目骨架。

什么是 MCP

MCP 是一个标准化的协议，让 AI 工具可以调用外部能力。AgileBuilder 实现了 MCP 服务端，提供以下工具：

| 工具 | 描述 | |------|------| | listTemplates | 列出所有可用模板 | | getTemplateInfo | 获取模板详情和变量定义 | | generateProject | 根据模板生成项目 |

配置 MCP 服务

启动 MCP 服务

agilebuilder mcp start

默认监听 http://localhost:3457。

配置 AI 工具

以 Cursor 为例，在设置中添加 MCP 服务：

{
  "mcp": {
    "servers": {
      "agilebuilder": {
        "url": "http://localhost:3457"
      }
    }
  }
}

使用示例

配置完成后，你可以在 AI 对话中这样使用：

"使用 react-starter 模板创建一个名为 my-app 的项目，启用 TypeScript"

AI 将调用 AgileBuilder MCP 工具：

  1. 调用 listTemplates 查看可用模板
  2. 调用 getTemplateInfo 获取模板变量
  3. 调用 generateProject 生成项目

MCP 工具详解

listTemplates

返回所有可用模板列表：

{
  "templates": [
    {
      "name": "react-starter",
      "description": "React 项目模板"
    }
  ]
}

getTemplateInfo

获取模板详细信息：

{
  "name": "react-starter",
  "variables": [
    {
      "name": "projectName",
      "type": "string",
      "required": true
    }
  ]
}

generateProject

生成项目：

{
  "template": "react-starter",
  "output": "./my-app",
  "variables": {
    "projectName": "my-app",
    "useTypeScript": true
  }
}

支持的 AI 工具

| 工具 | 支持状态 | |------|----------| | Cursor | ✅ 完整支持 | | Claude Code | ✅ 完整支持 | | GitHub Copilot | 🔄 即将支持 | | Windsurf | ✅ 完整支持 |

下一步