Skip to main content
Glama

BMAD MCP Server

by Dali1789
OverviewInspectSchemaRelated ServersScoreDiscussions
Python
Hybrid
MIT License
15
5

BMAD MCP Server ๐Ÿš€

MCP Compatible Python 3.8+ License: MIT

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 โœ…

Related MCP server: MCP Architect

๐Ÿš€ Quick Start

Prerequisites

  • Python 3.8+

  • OpenRouter API Key (for AI model routing)

  • Notion API Token (optional, for database sync)

Installation

# 1. Clone the repository git clone https://github.com/yourusername/bmad-mcp-server.git cd bmad-mcp-server # 2. Install dependencies pip install -r requirements.txt # 3. Set up environment variables cp .env.example .env # Edit .env with your API keys

Configuration

Add to your IDE's MCP configuration:

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" } } } }

๐Ÿ› ๏ธ 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

# List available agents bmad_list_agents() # Activate developer agent bmad_activate_agent(agent="dev") # Create a new task bmad_create_task( task_id="feature-implementation", name="Implement user authentication", allocated_hours=8.0, agent="dev" ) # Update progress bmad_update_task_progress( task_id="feature-implementation", hours_completed=2.5 ) # Get daily overview bmad_get_today_tasks()

Real-time Monitoring

# Start live monitoring bmad_start_realtime_mode() # Begin work session bmad_start_work_session(task_id="feature-implementation") # Work on task... # End session with automatic progress logging bmad_end_work_session( task_id="feature-implementation", hours_worked=2.0 ) # Get comprehensive status bmad_get_realtime_status()

Time & Cost Tracking โญ NEW!

# Start time tracking for a task bmad_start_timer( task_id="feature-implementation", agent="dev", session_type="development", description="Implementing user authentication system" ) # Stop timer with AI cost calculation bmad_stop_timer( task_id="feature-implementation", ai_model_used="claude-sonnet-4", tokens_input=1500, tokens_output=800, mark_completed=False ) # Get task time summary bmad_get_task_time_summary(task_id="feature-implementation") # Generate project billing report bmad_get_project_billing( project_id="my-project-id", start_date="2025-01-01", end_date="2025-01-31", export_format="invoice" # json, csv, or invoice ) # Get daily tracking report bmad_get_daily_time_report(date="2025-01-20") # Auto-end stale sessions (running >8 hours) bmad_auto_end_stale_sessions(max_hours=8)

Project Context

# Detect BMAD project bmad_detect_project(path="./my-project") # Register in global registry bmad_register_project( project_path="./my-project", project_name="My Awesome Project" ) # Get project overview bmad_get_project_status()

Template-System Usage โญ NEW!

# List available templates bmad_list_project_templates() # Get template details bmad_get_project_template_info(template_name="web-app") # Create new project with template bmad_create_project( project_path="./my-web-app", template="web-app", name="My Web Application", description="Modern React-based web application" ) # Migrate existing project bmad_migrate_project_to_standard( project_path="./legacy-project", backup=True )

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

# Simulate full work day bmad_simulate_work_day(speed_factor=10.0) # Test specific agent workflow bmad_simulate_agent_workday(agent="qa", hours=6.0) # Simulate crisis scenarios bmad_simulate_crisis_scenario(crisis_type="blocked_task")

Advanced Time Tracking Workflows โญ NEW!

# Start comprehensive work session bmad_start_timer( task_id="user-auth-system", agent="dev", session_type="development", description="Implementing OAuth2 integration" ) # Work on task with AI assistance # ... development work with AI model usage ... # Stop timer with detailed AI cost tracking bmad_stop_timer( task_id="user-auth-system", ai_model_used="claude-sonnet-4", tokens_input=2500, tokens_output=1200, mark_completed=True ) # Generate comprehensive project billing billing_report = bmad_get_project_billing( project_id="client-project-2025", start_date="2025-01-01", end_date="2025-01-31", export_format="invoice" ) # Monitor daily productivity daily_report = bmad_get_daily_time_report("2025-01-20") print(f"Today: {daily_report['total_hours']:.2f}h, ${daily_report['total_cost_usd']:.2f}") # Automatic session management bmad_auto_end_stale_sessions(max_hours=6) # End sessions > 6 hours

๐Ÿ—๏ธ Architecture

bmad-mcp-server/ โ”œโ”€โ”€ src/ โ”‚ โ””โ”€โ”€ bmad_mcp/ โ”‚ โ”œโ”€โ”€ core/ # Core functionality โ”‚ โ”‚ โ”œโ”€โ”€ task_tracker.py # Advanced task management โ”‚ โ”‚ โ”œโ”€โ”€ time_cost_tracker.py # Time & cost tracking โญ NEW! โ”‚ โ”‚ โ”œโ”€โ”€ console_formatter.py # Live output formatting โ”‚ โ”‚ โ”œโ”€โ”€ realtime_updater.py # Real-time monitoring โ”‚ โ”‚ โ”œโ”€โ”€ time_monitor.py # Scheduled monitoring โ”‚ โ”‚ โ”œโ”€โ”€ simulator.py # Demo & testing โ”‚ โ”‚ โ”œโ”€โ”€ notion_sync.py # Notion integration โ”‚ โ”‚ โ””โ”€โ”€ global_registry.py # Cross-IDE projects โ”‚ โ”œโ”€โ”€ agents/ # Agent definitions โ”‚ โ”‚ โ”œโ”€โ”€ analyst.py # Business analysis โ”‚ โ”‚ โ”œโ”€โ”€ architect.py # System design โ”‚ โ”‚ โ”œโ”€โ”€ developer.py # Code implementation โ”‚ โ”‚ โ”œโ”€โ”€ project_manager.py # Project coordination โ”‚ โ”‚ โ”œโ”€โ”€ qa.py # Quality assurance โ”‚ โ”‚ โ””โ”€โ”€ coder.py # Advanced semantic code analysis and editing โ”‚ โ”œโ”€โ”€ workflows/ # BMAD-METHOD workflow system โ”‚ โ”‚ โ”œโ”€โ”€ workflow_engine.py # Central workflow orchestration โ”‚ โ”‚ โ”œโ”€โ”€ orchestrator_agent.py # Project/Story lifecycle management โ”‚ โ”‚ โ”œโ”€โ”€ quality_gates.py # Quality assurance (@qa commands) โ”‚ โ”‚ โ””โ”€โ”€ workflow_states.py # State machine definitions โ”‚ โ”œโ”€โ”€ tools/ # MCP tool implementations โ”‚ โ”œโ”€โ”€ routing/ # OpenRouter integration โ”‚ โ””โ”€โ”€ server.py # MCP server โ”œโ”€โ”€ config/ # Configuration templates โ”œโ”€โ”€ docs/ # Documentation โ”œโ”€โ”€ examples/ # Usage examples โ””โ”€โ”€ tests/ # Test suite

๐Ÿ”ง Configuration

Environment Variables

# Required OPENROUTER_API_KEY=your_openrouter_api_key_here # Optional NOTION_TOKEN=your_notion_integration_token BMAD_MAX_DAILY_HOURS=10 BMAD_DEFAULT_AGENT=dev BMAD_LOG_LEVEL=INFO

Agent Configuration

Each agent can be customized via configuration files:

# config/bmad-global-config.yaml agents: dev: model: "anthropic/claude-3.5-sonnet" temperature: 0.1 max_tokens: 4000 architect: model: "anthropic/claude-3-opus" temperature: 0.3 max_tokens: 8000

๐Ÿณ Docker Deployment

# Build and run with Docker Compose docker-compose up -d # Environment variables via .env file cp .env.example .env # Edit .env file with your API keys docker-compose up -d

๐Ÿงช Testing

# Run test suite python -m pytest tests/ # Run specific test category python -m pytest tests/test_task_management.py # Run with coverage python -m pytest --cov=src/bmad_mcp tests/

๐Ÿ“š Documentation

๐Ÿค Contributing

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. 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

๐Ÿ™ Acknowledgments

Made with โค๏ธ for developers who love intelligent task management

One-click Deploy
A
security โ€“ no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dali1789/bmad-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server