mcp -spec-driven-development

This MCP server guides you through a spec-driven development workflow. It provides three core prompts: Generate Requirements (producing an EARS-formatted requirements document), Generate Design (creating a design document from the requirements), and Generate Code (generating implementation code from the design). You can integrate this server into MCP-enabled tooling and VS Code workflows to ensure a traceable path from requirements to design to code. Use the prompts in sequence to maintain consistency across artifacts and enable easier review and collaboration.

To use it, start the server through the configured command (for example via npx as shown in the configuration). Once running, invoke the available prompts in your MCP client: generate-requirements to create an EARS-based requirements.md, then generate-design-from-requirements to produce a design.md from those requirements, and finally generate-code-from-design to generate the implementation code based on the design. This creates a repeatable, auditable process that aligns development artifacts with a spec-driven approach.

Prerequisites:

• Node.js 20+ installed on your system
• Internet access to fetch packages via npm/npx

Installation steps:

1. Ensure you have Node.js 20+ installed. You can verify with:

node -v

2. Install and run the MCP server via NPX (no permanent installation required):

npx -y mcp-server-spec-driven-development@latest

Alternatively, you can configure a persistent server in mcp.json in your project:

{
  "mcp": {
    "servers": {
      "spec-driven": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-server-spec-driven-development@latest"
        ]
      }
    }
  }
}

3. If you are using a VS Code workflow or Cursor, follow the Quick Start buttons in the README to initialize the server via the provided URLs, or rely on the mcp.json snippet above for automatic startup in MCP-enabled environments.

Tips and notes:

• This MCP server focuses on a three-stage, spec-driven workflow: requirements (EARS format), design, and code. Ensure you provide clear, high-quality inputs at the requirements stage to maximize design and code quality.
• The available prompts are Generate Requirements (generate-requirements), Generate Design from Requirements (generate-design-from-requirements), and Generate Code from Design (generate-code-from-design).
• If you encounter network or permission issues when using npx, try updating npm, clearing the npm cache, or using a local installation approach.
• Maintain a consistent project structure (e.g., specs/requirements.md, specs/design.md) to ensure smooth prompt processing.
• This server reviews and produces artifacts in a predictable location (e.g., specs/requirements.md, specs/design.md, and root-level code) to support traceability from requirements to code.