BMAD MCP Server

<div align="center">

一个将 BMAD 方法 带给AI助手的模型上下文协议服务器。

特性 • 安装 • 使用 • 文档

</div>

---

概述

BMAD MCP Server 提供了对来自BMAD（构建现代应用程序的决定性方法）的11个专业代理和超过36个自动化工作流的访问。只需配置一次，即可在所有项目中使用。

什么是BMAD？

BMAD 是一种全面的软件开发方法论，具有针对不同角色（业务分析师、架构师、开发者、用户体验设计师等）的专业AI代理，以及针对常见任务的工作流（产品需求文档生成、架构设计、调试、测试）。

为什么是MCP？

无需将BMAD文件复制到每个项目，MCP服务器提供了通用访问：

• ✅ 单次安装适用于所有项目
• ✅ 在所有地方保持一致的方法论
• ✅ 不会污染项目
• ✅ 容易更新

---

特性

统一工具架构

单一的 bmad 工具，具有智能操作：

// 列出可用的代理和工作流
{ operation: "list", query: "agents" }

// 读取代理详情（不执行）
{ operation: "read", type: "agent", agent: "analyst" }

// 使用上下文执行代理
{ operation: "execute", agent: "analyst", message: "帮助我..." }

11个专业代理

代理	角色	加载方式
📊 Mary	业务分析师	analyst
🏗️ Winston	系统架构师	architect
💻 Amelia	开发者	dev
🎨 Sally	用户体验设计师	ux-designer
🧪 Murat	测试架构师	tea
📋 John	产品经理	pm
🔄 Bob	敏捷教练	sm
🐛 Diana	调试专家	debug
...	[+3更多代理]

超过36个自动化工作流

prd              # 产品需求文档
architecture     # 系统架构设计
debug-inspect    # 全面调试
atdd             # 接受测试生成
ux-design        # 用户体验规范
party-mode       # 多代理头脑风暴
... 和30多个更多

MCP能力

• 工具 - 统一的 bmad 工具用于所有操作
• 资源 - 通过 bmad:// URI 访问BMAD文件
• 提示 - 代理作为原生MCP提示
• 完成 - 参数的智能自动完成功能
• 多源 - 支持项目、用户和Git远程

---

安装

预备条件

• Node.js 18或更高版本
• 与MCP兼容的客户端（Claude Desktop、VS Code与Copilot、Cline等）

快速开始

选项1：npx（推荐）

添加到您的MCP客户端配置：

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"]
    }
  }
}

选项2：全局安装

npm install -g bmad-mcp-server

{
  "mcpServers": {
    "bmad": {
      "command": "bmad-mcp-server"
    }
  }
}

选项3：本地开发

git clone https://github.com/mkellerman/bmad-mcp-server.git
cd bmad-m_ cp-server
npm install
npm run build

{
  "mcpServers": {
    "bmad": {
      "command": "node",
      "args": ["/绝对路径/to/bmad-mcp-server/build/index.js"]
    }
  }
}

客户端特定设置

<details> <summary><b>Claude Desktop</b></summary>

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"]
    }
  }
}

重启Claude Desktop。

</details> <details> <summary><b>VS Code与GitHub Copilot</b></summary>

1. 安装最新版GitHub Copilot扩展
2. 打开设置（JSON）
3. 添加到 github.copilot.chat.mcp.servers：

{
  "github.copilot.chat.mcp.servers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"]
    }
  }
}

4. 重启VS Code

</details> <details> <summary><b>Cline（VS Code扩展）</b></summary>

1. 打开Cline设置
2. 添加MCP服务器：

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"]
    }
  }
}

</details>

---

使用

自然语言示例

只需自然地询问您的AI助手——它会自动处理MCP工具调用：

代理执行：

您："让Mary分析SaaS产品的市场机会"
→ AI执行：{ operation: "execute", agent: "analyst", message: "..." }
→ Mary（业务分析师）提供市场分析

工作流执行：

您："启动任务管理应用的PRD工作流"
→ AI执行：{ operation: "execute", workflow: "prd", message: "..." }
→ John（产品经理）引导您创建PRD

调试协助：

您："让Diana调试这个脚本"（附带代码）
→ AI执行：{ operation: "execute", agent: "debug", message: "..." }
→ Diana启动全面调试工作流

协作问题解决：

您："启动party-mode，与规划团队一起头脑风暴功能"
→ AI执行：{ operation: "execute", workflow: "party-mode", message: "..." }
→ 多个代理协作进行头脑风暴会议

架构审查：

您："让Winston审查这个系统设计"
→ AI执行：{ operation: "execute", agent: "architect", message: "..." }
→ Winston提供架构指导

直接使用MCP工具

您也可以直接使用该工具（对于开发/测试非常有用）：

列出可用代理：

{
  "operation": "list",
  "query": "agents"
}

执行代理：

{
  "operation": "execute",
  "agent": "analyst",
  "message": "帮助我分析SaaS产品的市场"
}

运行工作流：

{
  "operation": "execute",
  "workflow": "prd",
  "message": "创建任务管理应用的PRD"
}

读取代理详情：

{
  "operation": "read",
  "type": "agent",
  "agent": "architect"
}

高级配置

使用Git远程加载多源内容：

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": [
        "-y",
        "bmad-mcp-server",
        "git+https://github.com/org/custom-bmad.git#main"
      ]
    }
  }
}

自定义项目根目录：

{
  "mcpServers": {
    "bmad": {
      "command": "npx",
      "args": ["-y", "bmad-mcp-server"],
      "env": {
        "BMAD_ROOT": "/自定义/bmad/位置"
      }
    }
  }
}

资源发现优先级

服务器按以下顺序搜索BMAD内容：

1. 项目本地：./bmad/（最高优先级 - 项目定制）
2. 用户全局：~/.bmad/（个人默认）
3. Git远程：克隆到 ~/.bmad/cache/git/（共享/团队内容）
4. 包默认：内置BMAD文件（始终可用）

---

文档

• 架构 - 系统设计和组件
• API合约 - MCP工具和TypeScript API
• 开发指南 - 贡献和测试
• 发布流程 - 维护者的发布工作流

---

开发

设置

# 克隆仓库
git clone https://github.com/mkellerman/bmad-mcp-server.git
cd bmad-mcp-server

# 安装依赖
npm install

# 构建
npm run build

# 运行测试
npm test

项目结构

src/
├── index.ts              # MCP服务器入口点
├── cli.ts                # CLI入口点
├── server.ts             # MCP服务器实现
├── core/
│   ├── bmad-engine.ts    # 核心业务逻辑
│   └── resource-loader.ts # 多源内容加载
├── tools/
│   ├── bmad-unified.ts   # 统一工具实现
│   └── operations/       # 操作处理器
├── types/                # TypeScript类型
└── utils/                # 实用工具

npm脚本

npm run build          # 编译TypeScript
npm run dev            # 开发模式，自动重启
npm test               # 运行所有测试
npm run test:unit      # 仅单元测试
npm run test:coverage  # 覆盖报告
npm run lint           # 检查代码风格
npm run format         # 格式化代码

测试

# 运行所有测试
npm test

# 运行覆盖测试
npm run test:coverage

# 运行特定测试套件
npm run test:unit
npm run test:integration
npm run test:e2e

# 监视模式
npm run test:watch

---

架构

高级概述

AI助手（Claude，Copilot等）
         ↓ MCP协议
    MCP服务器层
         ↓
    BMAD引擎（传输无关）
         ↓
  资源加载器（多源）
         ↓
   BMAD内容（代理，工作流）

关键组件

• 服务器：MCP协议实现（工具、资源、提示）
• 引擎：传输无关的业务逻辑
• 加载器：多源内容发现和加载
• 工具：统一的 bmad 工具，具有模块化操作

详见 架构文档。

---

贡献

我们欢迎贡献！请参阅我们的 开发指南：

• 开发设置
• 代码风格指南
• 测试要求
• 拉取请求过程

快速贡献指南

1. 分叉仓库
2. 创建功能分支：git checkout -b feature/my-feature
3. 带有测试的更改
4. 运行测试：npm test
5. 提交：git commit -m "feat: 添加我的功能"
6. 推送：git push origin feature/my-feature
7. 创建拉取请求

我们使用 常规提交 作为提交消息。

---

许可证

ISC © mkellerman

---

致谢

此MCP服务器基于 BMAD方法。所有方法论、代理、工作流和最佳实践均归功于原始的BMAD方法项目。

---

链接

• 仓库：https://github.com/mkellerman/bmad-mcp-server
• 问题：https://github.com/mkellerman/bmad-mcp-server/issues
• npm包：https://www.npmjs.com/package/bmad-mcp-server
• BMAD方法：https://github.com/bmad-code-org/BMAD-METHOD
• MCP规范：https://modelcontextprotocol.io/