AgileBuilder logoAgileBuilder
返回文档

MCP

了解 Model Context Protocol 集成

概述

MCP（Model Context Protocol）是一种标准协议，允许 AI 工具（如 Cursor、Claude Code、Windsurf）与 AgileBuilder 交互。

通过 MCP，AI 可以：

  • 查看可用模板
  • 获取模板详情
  • 生成项目

MCP 让 AI 与人类使用同一套模板体系，确保 AI 生成的代码符合团队规范。

MCP 工具

AgileBuilder 提供以下 MCP 工具：

listTemplates

列出所有可用模板。

返回：

{
  "templates": [
    {
      "name": "react-starter",
      "description": "React 项目启动模板"
    },
    {
      "name": "vue-admin",
      "description": "Vue 管理后台模板"
    }
  ]
}

getTemplateInfo

获取模板详细信息和变量定义。

参数：

{
  "template": "react-starter"
}

返回：

{
  "name": "react-starter",
  "description": "React 项目启动模板",
  "variables": [
    {
      "name": "projectName",
      "type": "string",
      "required": true
    },
    {
      "name": "useTypeScript",
      "type": "boolean",
      "default": true
    }
  ]
}

generateProject

根据模板生成项目。

参数：

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

返回：

{
  "success": true,
  "projectPath": "./my-app",
  "message": "项目生成成功"
}

配置 MCP 服务

启动 MCP 服务

agilebuilder mcp start

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

配置 AI 工具

Cursor

在 Cursor 设置中添加 MCP 服务：

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

Claude Code

在 Claude Code 配置中添加：

claude code --mcp agilebuilder http://localhost:3457

Windsurf

在 Windsurf 设置中配置 MCP 服务器地址。

AI 使用示例

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

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

AI 将自动调用：

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

支持的 AI 工具

工具支持状态说明
Cursor✅ 完整支持MCP 配置完整
Claude Code✅ 完整支持MCP 配置完整
Windsurf✅ 完整支持MCP 配置完整
GitHub Copilot🔄 即将支持等待官方支持

文档资源

MCP 还可以访问你在 AgileBuilder 中录入的文档：

resource://agile-builder/docs/coding-standards
resource://agile-builder/docs/api-spec

AI 可以实时查询这些文档，确保生成内容符合团队规范。

下一步