1. 服务概述一句话简介实现BMAD业务建模和开发方法论的MCP服务器提供智能任务管理、多代理工作流和跨IDE项目管理服务名称BMAD MCP Server版本号v2.0开发者/提供方Dali1789协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供以下核心功能2.1 六个专业AI代理 分析师业务分析、市场研究、需求收集️ 架构师系统设计、架构规划、技术栈选择 开发者代码实现、调试、技术开发 项目经理任务协调、时间线管理、资源规划 QA质量保证、测试策略、代码审查 编码代理高级语义代码分析和编辑能力2.2 高级任务管理实时进度跟踪实时更新和通知智能调度自动分配与容量管理后续任务生成自动工作流推进Notion集成与Notion数据库双向同步TodoWrite桥接无缝Claude集成2.3 时间和成本跟踪精确时间跟踪每个项目的确切时间与会话管理AI成本计算自动计算每个项目的AI模型成本项目计费客户发票的综合计费报告多格式导出JSON、CSV和发票样式计费报告成本优化跟踪和优化跨项目的AI模型使用会话管理自动结束过期会话并跟踪工作模式2.4 模板系统和标准化项目结构6个项目模板standard、web-app、api、mobile、data-science、infrastructure自动结构创建统一的.bmad-core/目录自动发现自动识别新的BMAD项目迁移工具将现有项目迁移到BMAD v2.0标准零设置新项目立即投入使用配置完整2.5 BMAD-METHOD工作流系统完整实现与智能编排质量门qa命令6个综合质量保证命令高级语义代码分析通过编码代理提供专业代码智能基于时间的监控计划提醒和进度检查工作日模拟演示模式和现实进度测试3. 使用场景描述该服务适合在什么情况下使用项目管理综合项目概览多项目支持任务协调智能任务调度和进度跟踪多代理协作6个专业代理协同工作时间成本跟踪精确跟踪项目时间和AI成本质量保证质量门和测试策略代码分析语义代码分析和编辑项目模板标准化项目结构创建跨IDE访问兼容任何支持MCP的IDE4. 接入方式4.1 服务端点该MCP服务器通过Python运行支持以下方式启动python -m src.bmad_mcp.server4.2 认证与权限使用该服务需要以下认证信息OpenRouter API Key用于AI模型路由Notion API Token可选用于数据库同步4.3 数据格式服务支持以下数据格式请求格式JSON格式的MCP协议消息响应格式JSON格式的任务和项目数据4.4 服务器配置Claude Code配置claude_desktop_config.json{ mcpServers: { bmad: { command: python, args: [-m, src.bmad_mcp.server], cwd: /path/to/bmad-mcp-server, env: { PYTHONPATH: /path/to/bmad-mcp-server, OPENROUTER_API_KEY: your_openrouter_api_key, NOTION_TOKEN: your_notion_token } } } }VS Code / Cursor配置{ mcp.servers: { bmad: { command: python, args: [-m, src.bmad_mcp.server], cwd: /path/to/bmad-mcp-server, env: { PYTHONPATH: /path/to/bmad-mcp-server, OPENROUTER_API_KEY: your_openrouter_api_key } } } }5. 接口定义该MCP服务器提供以下工具类别5.1 代理管理bmad_list_agents列出所有可用代理bmad_activate_agent切换到特定代理bmad_get_agent_help获取代理特定指导5.2 任务管理bmad_get_task_summary综合任务概览bmad_create_task创建新任务并自动调度bmad_update_task_progress更新进度并实时同步bmad_get_today_tasks今日计划任务bmad_get_agent_tasks代理特定任务列表5.3 时间和成本跟踪bmad_start_timer启动任务时间跟踪bmad_stop_timer停止计时器并计算成本bmad_get_active_timers列出所有当前运行的计时器bmad_get_task_time_summary任务时间跟踪摘要bmad_get_daily_time_report每日时间跟踪报告bmad_get_project_billing生成项目计费报告5.4 BMAD-METHOD工作流系统bmad_workflow_start_project启动BMAD-METHOD项目工作流bmad_workflow_advance推进工作流到下一状态bmad_workflow_start_story在开发周期中创建故事bmad_workflow_run_qa执行质量门bmad_workflow_execute_command智能路由代理命令bmad_workflow_get_status获取综合工作流状态5.5 语义代码分析bmad_coder_activate_project激活项目进行分析bmad_coder_find_symbol语义查找代码符号bmad_coder_get_symbols_overview获取文件符号概览bmad_coder_find_referencing_symbols查找符号引用bmad_coder_insert_after_symbol在符号后插入代码bmad_coder_replace_symbol_body替换符号实现5.6 模板系统bmad_create_project使用标准化结构创建项目bmad_list_project_templates显示所有可用模板bmad_get_project_template_info详细模板信息bmad_migrate_project_to_standard迁移现有项目6. 快速开始6.1 环境要求Python 3.8OpenRouter API Key用于AI模型路由Notion API Token可选用于数据库同步6.2 示例代码安装步骤git clone https://github.com/yourusername/bmad-mcp-server.git cd bmad-mcp-server pip install -r requirements.txt cp .env.example .env # 编辑.env文件填入API密钥基本任务管理bmad_list_agents() bmad_activate_agent(agentdev) bmad_create_task( task_idfeature-implementation, name实现用户认证, allocated_hours8.0, agentdev ) bmad_update_task_progress( task_idfeature-implementation, hours_completed2.5 ) bmad_get_today_tasks()时间和成本跟踪bmad_start_timer( task_idfeature-implementation, agentdev, session_typedevelopment, description实现用户认证系统 ) bmad_stop_timer( task_idfeature-implementation, ai_model_usedclaude-sonnet-4, tokens_input1500, tokens_output800, mark_completedFalse ) bmad_get_project_billing( project_idmy-project-id, start_date2025-01-01, end_date2025-01-31, export_formatinvoice )模板系统使用bmad_list_project_templates() bmad_create_project( project_path./my-web-app, templateweb-app, name我的Web应用, description现代React Web应用 )7. 注意事项API密钥安全妥善保管OpenRouter和Notion API密钥不要提交到版本控制系统多代理协作6个专业代理可协同工作根据任务类型激活相应代理时间跟踪精确跟踪项目时间和AI成本支持多种计费报告格式项目模板使用标准化模板快速创建项目确保结构一致性质量保证使用质量门qa命令确保项目质量代码分析编码代理提供高级语义代码分析和编辑能力跨IDE支持兼容Claude Code、VS Code、Cursor等任何支持MCP的IDENotion集成可选的Notion数据库双向同步功能会话管理自动结束过期会话跟踪工作模式8. 可用项目模板模板名称描述standard基础BMAD项目完整结构web-app前端/后端支持React/Vue/AngularapiREST/GraphQL API包含OpenAPI文档mobileReact Native/Flutter跨平台应用data-scienceML/Jupyter包含笔记本和数据管道infrastructureDocker/Terraform/Kubernetes部署