Back to Home
mkellerman icon

bmad-mcp-server

by mkellerman

Overview

Provides AI assistants with access to specialized agents and automated workflows from the BMAD (Business Methodology Automation and Delivery) methodology.

Installation

Run Command
npx -y bmad-mcp-server

Environment Variables

  • BMAD_ROOT
  • BMAD_DEBUG
  • LITELLM_PROXY_URL
  • LITELLM_PROXY_API_KEY
  • LLM_MODEL
  • SKIP_LLM_TESTS
  • LITELLM_PORT
  • NODE_ENV

Security Notes

A critical path traversal vulnerability exists in the `ReadResourceRequestSchema` handler and `ResourceLoaderGit.loadFile` function. If a malicious actor can control the `uri` parameter (e.g., `bmad:///etc/passwd` or `bmad://../../../../etc/passwd`), they can read arbitrary files on the system that the Node.js process has access to. The `path.join` function, when given an absolute path segment (like `/etc/passwd`) or enough `../` segments, can escape the intended `bmadRoot` directory. This allows unauthorized access to sensitive data. Additionally, while Git cloning to `~/.bmad/cache/git` limits impact, it still involves executing external `git` commands with URLs that could potentially be malicious, though `--depth 1` helps mitigate some deep repository risks.

Similar Servers

Stats

Interest Score50
Security Score3
Cost ClassHigh
Avg Tokens5000
Stars54
Forks9
Last Update2026-01-05

Tags

MCPAI AgentsWorkflowsMethodologyDevelopmentGitCLITypeScriptNode.jsLLM Integration