Skip to content

formulahendry/mcp-server-spec-driven-development

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spec-Driven Development MCP Server

NPM Downloads Install in VS Code

Model Context Protocol (MCP) server that facilitates spec-driven development workflows by providing structured prompts for generating requirements, design documents, and code following a systematic approach.

Spec-Driven Development Server MCP server

🎯 Purpose

This MCP server enables developers to follow a structured spec-driven development approach by providing prompts that guide you through:

  1. Requirements Generation - Create detailed requirements documents using the EARS (Easy Approach to Requirements Syntax) format
  2. Design Generation - Generate design documents based on requirements
  3. Code Generation - Generate implementation code based on design documents

✨ Features

  • Structured Workflow: Follows a clear progression from requirementsdesigncode
  • EARS Format Support: Uses industry-standard EARS format for requirements documentation
  • MCP Protocol: Integrates seamlessly with MCP-compatible tools and environments

🚀 Quick Start

Prerequisites

  • Node.js 20+

Installation

VS Code

Install the MCP server in VS Code using below buttons:

Install in VS Code Install in VS Code Insiders

Alternatively, you can add configuration in mcp.json:

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

Cursor, Claude Code

Install the MCP server in Cursor using below button:

Install MCP Server

Alternatively, you can add configuration in mcp.json:

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

📋 Available Prompts

1. Generate Requirements Document

  • Name: generate-requirements
  • Description: Generate requirements.md using EARS format
  • Input: High-level requirements of the application. Example: 'A Vue.js todo application with task creation, completion tracking, and local storage persistence'
  • Output: Structured requirements document in specs/requirements.md

2. Generate Design from Requirements

  • Name: generate-design-from-requirements
  • Description: Generate design.md from requirements.md
  • Input: Reads from specs/requirements.md
  • Output: Design document in specs/design.md

3. Generate Code from Design

  • Name: generate-code-from-design
  • Description: Generate code from design.md
  • Input: Reads from specs/design.md
  • Output: Implementation code in the root folder

📖 Workflow Example

  1. Start with Requirements: Use the generate-requirements prompt with your initial requirements text
  2. Create Design: Use generate-design-from-requirements to create a design document based on your requirements
  3. Generate Code: Use generate-code-from-design to generate implementation code from your design

This creates a traceable path from requirements through design to implementation, ensuring consistency and completeness in your development process.

🤔 Why Spec-Driven Development?

Moving beyond Vibe Coding to a structured, specification-driven approach brings clarity, consistency, and maintainability to your development workflow. Instead of coding by intuition alone, Spec-Driven Development provides a systematic foundation that scales with your project's complexity.

Learn more about the benefits: Goodbye, Vibe Coding! Hello, Spec-Driven Development MCP Server!