Provides containerized deployment support for production-ready BMAD MCP server instances with Docker and Docker Compose configurations
Enables GitHub integration for BMAD architect and developer agents, supporting code repositories, system design documentation, and development workflows
Integrates with Google's Gemini Pro 1.5 model through OpenRouter for the BMAD project management agent, handling project planning and resource management tasks
Provides comprehensive integration with Notion databases for business resources, project management, task tracking, and automated synchronization of BMAD project documentation and workflows
Integrates with Perplexity's Llama-3.1-Sonar model for the BMAD analyst agent, enabling market research, competitive analysis, data gathering, and trend analysis with web research capabilities
BMAD MCP Server 🚀
A comprehensive Model Context Protocol (MCP) server implementing the BMAD (Business Modeling and Development) methodology. Provides intelligent task management, multi-agent workflows, and cross-IDE project management through the MCP protocol.
✨ Features
🤖 6 Specialized AI Agents
- 📊 Analyst: Business analysis, market research, requirement gathering
- 🏗️ Architect: System design, architecture planning, tech stack selection
- 💻 Developer: Code implementation, debugging, technical development
- 📋 Project Manager: Task coordination, timeline management, resource planning
- 🔍 QA: Quality assurance, testing strategies, code review
- 🔍 Coder Agent: Advanced semantic code analysis and editing capabilities ⭐ NEW!
📋 Advanced Task Management
- Real-time Progress Tracking: Live updates and notifications
- Intelligent Scheduling: Auto-allocation with capacity management
- Follow-up Task Generation: Automatic workflow progression
- Notion Integration: Bi-directional sync with Notion databases
- TodoWrite Bridge: Seamless Claude integration
⏱️ Time & Cost Tracking ⭐ NEW!
- Precise Time Tracking: Exact time spent on each project with session management
- AI Cost Calculation: Automatic calculation of AI model costs per project
- Project Billing: Comprehensive billing reports for client invoicing
- Multi-format Export: JSON, CSV, and invoice-style billing reports
- Cost Optimization: Track and optimize AI model usage across projects
- Session Management: Auto-end stale sessions and track work patterns
🎨 Template-System & Standardisierte Projektstrukturen ⭐ NEW!
- 6 Projekt-Templates: standard, web-app, api, mobile, data-science, infrastructure
- Automatische Struktur-Erstellung: Einheitliche
.bmad-core/
Verzeichnisse - Auto-Discovery: Erkennt automatisch neue BMAD-Projekte
- Migration-Tools: Migriert bestehende Projekte auf BMAD v2.0 Standard
- Zero-Setup: Neue Projekte sind sofort produktiv mit kompletter Konfiguration
🔄 Enhanced Features
- BMAD-METHOD Workflow System: Complete implementation with intelligent orchestration ⭐ NEW!
- Quality Gates (@qa commands): 6 comprehensive quality assurance commands ⭐ NEW!
- Advanced Semantic Code Analysis: Professional code intelligence via Coder Agent ⭐ NEW!
- Time-based Monitoring: Scheduled reminders and progress checks
- Work Day Simulation: Demo modes and realistic progression testing
- Live Console Output: Beautiful formatted status displays
- Project Context Integration: Multi-project support with global registry
- Performance Metrics: Detailed tracking and reporting
🌐 Universal IDE Access
Compatible with any IDE supporting MCP:
- Claude Code ✅
- VS Code ✅
- Cursor ✅
- Any MCP-compatible IDE ✅
🚀 Quick Start
Prerequisites
- Python 3.8+
- OpenRouter API Key (for AI model routing)
- Notion API Token (optional, for database sync)
Installation
Configuration
Add to your IDE's MCP configuration:
Claude Code (claude_desktop_config.json
)
VS Code / Cursor
🛠️ Available MCP Tools
🤖 Agent Management
Tool | Description | Example |
---|---|---|
bmad_list_agents | List all available agents | Shows 5 specialized agents |
bmad_activate_agent | Switch to specific agent | agent: "dev" |
bmad_get_agent_help | Get agent-specific guidance | Context-aware help |
📋 Task Management
Tool | Description | Example |
---|---|---|
bmad_get_task_summary | Comprehensive task overview | Progress, metrics, status |
bmad_create_task | Create new task with auto-scheduling | task_id , name , hours |
bmad_update_task_progress | Update progress with real-time sync | task_id , hours_completed |
bmad_get_today_tasks | Today's scheduled tasks | Daily workload view |
bmad_get_agent_tasks | Agent-specific task list | Filter by agent |
⏱️ Time & Cost Tracking ⭐ NEW!
Tool | Description | Example |
---|---|---|
bmad_start_timer | Start time tracking for a task | task_id , agent , session_type |
bmad_stop_timer | Stop timer and calculate costs | task_id , ai_model , tokens |
bmad_get_active_timers | List all currently running timers | Active sessions overview |
bmad_get_task_time_summary | Time tracking summary for task | Hours, cost, sessions |
bmad_get_daily_time_report | Daily time tracking report | Project breakdown, hours |
bmad_get_project_billing | Generate project billing report | JSON, CSV, invoice formats |
bmad_auto_end_stale_sessions | End sessions running too long | Cleanup stale timers |
bmad_update_model_costs | Update AI model pricing | Configure cost per token |
bmad_get_model_costs | Get current model costs | View pricing configuration |
⚡ Enhanced Features
Tool | Description | Example |
---|---|---|
bmad_start_realtime_mode | Enable live task monitoring | Background updates |
bmad_start_work_session | Track work session for task | Time tracking |
bmad_simulate_work_day | Demo realistic work progression | Testing & demos |
bmad_get_project_status | Comprehensive project overview | Multi-project support |
bmad_sync_notion_tasks | Sync with Notion databases | Bi-directional sync |
🔧 Project Management
Tool | Description | Example |
---|---|---|
bmad_detect_project | Scan for BMAD configuration | Auto-discovery |
bmad_register_project | Add project to global registry | Cross-IDE access |
bmad_execute_task | Run BMAD methodology tasks | Template-based execution |
bmad_create_document | Generate documents from templates | Automated documentation |
bmad_run_checklist | Quality assurance checklists | QA workflows |
🚀 BMAD-METHOD Workflow System ⭐ NEW!
Tool | Description | Example |
---|---|---|
bmad_workflow_start_project | Start BMAD-METHOD project workflow | Full/planning/development modes |
bmad_workflow_advance | Advance workflow to next state | Project/story state transitions |
bmad_workflow_start_story | Create story in development cycle | Story creation & planning |
bmad_workflow_run_qa | Execute quality gate (@qa commands) | *risk, *design, *trace, *nfr, *review, *gate |
bmad_workflow_execute_command | Route agent commands intelligently | Context-aware agent routing |
bmad_workflow_get_status | Get comprehensive workflow status | Real-time progress monitoring |
bmad_workflow_generate_report | Generate detailed workflow reports | Analytics & recommendations |
🔍 Semantic Code Analysis ⭐ NEW!
Tool | Description | Example |
---|---|---|
bmad_coder_activate_project | Activate project for analysis | Semantic code intelligence |
bmad_coder_find_symbol | Find code symbols semantically | Functions, classes, variables |
bmad_coder_get_symbols_overview | Get file symbol overview | Code structure analysis |
bmad_coder_find_referencing_symbols | Find symbol references | Cross-reference tracking |
bmad_coder_insert_after_symbol | Insert code after symbol | Precise code insertion |
bmad_coder_replace_symbol_body | Replace symbol implementation | Code modification |
bmad_coder_execute_shell_command | Execute shell commands | Testing, building, automation |
bmad_coder_search_for_pattern | Advanced pattern search | Intelligent code search |
bmad_coder_write_memory | Store project knowledge | Persistent insights |
bmad_coder_read_memory | Load stored knowledge | Access project memories |
🎨 Template-System ⭐ NEW!
Tool | Description | Example |
---|---|---|
bmad_create_project | Create project with standardized structure | path , template |
bmad_list_project_templates | Show all available templates | 6 templates available |
bmad_get_project_template_info | Detailed template information | Features, structure |
bmad_migrate_project_to_standard | Migrate existing project | Auto-backup, structure |
📊 Usage Examples
Basic Task Management
Real-time Monitoring
Time & Cost Tracking ⭐ NEW!
Project Context
Template-System Usage ⭐ NEW!
Available Templates
- standard: Basic BMAD project with full structure
- web-app: Frontend/Backend with React/Vue/Angular support
- api: REST/GraphQL APIs with OpenAPI documentation
- mobile: React Native/Flutter cross-platform apps
- data-science: ML/Jupyter with notebooks and data pipelines
- infrastructure: Docker/Terraform/Kubernetes deployments
Simulation & Testing
Advanced Time Tracking Workflows ⭐ NEW!
🏗️ Architecture
🔧 Configuration
Environment Variables
Agent Configuration
Each agent can be customized via configuration files:
🐳 Docker Deployment
🧪 Testing
📚 Documentation
- BMAD Workflow System - Complete workflow implementation guide ⭐ NEW!
- API Reference - Complete tool documentation
- Agent Guide - Working with specialized agents
- Task Management - Advanced task workflows
- Quality Gates Guide - @qa commands and quality assurance ⭐ NEW!
- Serena Integration - LSP-based code intelligence ⭐ NEW!
- Project Setup - BMAD project configuration
- Integration Guide - IDE setup instructions
- Troubleshooting - Common issues and solutions
🤝 Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
📈 Roadmap
✅ Recently Completed (v2.1)
- Time & Cost Tracking System: Precise project billing with AI cost calculation ⭐ NEW!
- BMAD-METHOD Workflow System: Complete workflow implementation with intelligent orchestration
- Quality Gates System: All 6 @qa commands (*risk, *design, *trace, *nfr, *review, *gate)
- Serena Bridge Agent: LSP-based semantic code intelligence integration
- Agent Coordination: 6-agent ecosystem with smart routing and collaboration
- Template-System: 6 standardized project templates
- Auto-Discovery: Automatic project detection and integration
- Migration Tools: Legacy project migration to BMAD v2.0
- Standardized Structure: Unified
.bmad-core/
project layout
🔄 In Progress (v2.2)
- Workflow Automation: Advanced automation rules and triggers
- Multi-Project Workflows: Cross-project dependency management
- Enhanced Analytics: Workflow performance insights and optimization
- Custom Quality Gates: User-definable quality criteria and checks
🚀 Planned Features (v3.0)
- Web Dashboard: Browser-based workflow management interface
- Team Collaboration: Multi-user project support with role-based access
- Enterprise Workflows: Advanced enterprise features and compliance
- Serena Enhancements: Multi-language LSP support and AI-assisted refactoring
- Plugin System: Custom agent and quality gate development
- Mobile App: Companion mobile application for workflow monitoring
- Template Marketplace: Community-driven template sharing platform
🔐 Security
- All API keys managed via environment variables
- No secrets stored in code or configuration files
- Secure MCP protocol communication
- Optional token rotation and audit logging
See SECURITY.md for security guidelines.
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
💬 Support
- Documentation: docs/
- Issues: GitHub Issues
- Discussions: GitHub Discussions
🙏 Acknowledgments
- Model Context Protocol - For the excellent MCP specification
- OpenRouter - For multi-model API access
- Notion - For database integration capabilities
Made with ❤️ for developers who love intelligent task management
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Provides intelligent agent routing with 5 specialized AI agents (analyst, architect, dev, pm, qa) through OpenRouter integration. Enables unified project structure across all IDEs with global registry management and automated BMAD methodology workflows.
Related MCP Servers
- AsecurityAlicenseAqualityProvides integration with OpenRouter.ai, allowing access to various AI models through a unified interface.Last updated -2857Apache 2.0
- AsecurityAlicenseAqualityFacilitates comprehensive architectural design and evaluation through specialized agents, rich resources, and powerful tools covering diverse architectural domains, including cloud, AI, and blockchain.Last updated -31,40627ISC License
- AsecurityAlicenseAqualityAn AI router that connects applications to multiple LLM providers (OpenAI, Anthropic, Google, DeepSeek, Ollama, etc.) with smart model orchestration capabilities, enabling dynamic switching between models for different reasoning tasks.Last updated -35419MIT License
- -securityAlicense-qualityA professional AI agent system that provides 10+ specialized agents and 25+ MCP tools to support development workflows in Cursor IDE, with dual LLM mode support (built-in and DeepSeek API).Last updated -2MIT License