Spec Coding MCP

🚀 Spec Coding MCP Server

Transform feature ideas into production-ready code through systematic Spec-Driven Development

📚 Documentation

• 简体中文

✨ Features

What is Spec-Driven Development?

Spec-Driven Development is, in simple terms, a software development process where clear and detailed specifications act as the core driver throughout the entire development workflow. These specifications cover various aspects such as the functional requirements, performance metrics, interface definitions, and data formats of the software system. They are like blueprints in construction, clearly outlining for developers what the final software should look like.

The core of spec-driven development is to transform vague requirements into an executable, traceable, and verifiable development process through standardized specification documents. Essentially, it integrates the rigor of traditional software engineering into AI programming, changing development from "vibe coding" (relying on intuition) to a controllable engineering process.

The key to spec-driven development is the "Spec folder". Each functional module corresponds to a Spec folder containing 3 core files that "materialize" requirements, designs, and tasks:

• requirements.md (Requirements Document): Uses EARS syntax (Easy Approach to Requirements Syntax) to write user stories and acceptance criteria, avoiding vague expressions.
• design.md (Technical Solution): Includes details such as architectural design, process logic, technology selection, and potential risks.
• tasks.md (Task List): Breaks down the technical solution into executable specific tasks (todolist).

🚀 Quick Start

Implementing Spec-Driven Development with spec-coding-mcp

The MCP in spec-coding-mcp stands for Model Context Protocol, which is an important bridge connecting external tools with the AI IDE. As long as your AI IDE can use MCP, you can use spec-coding-mcp.

Here, we'll take GitHub Copilot as an example to introduce how to use spec-coding-mcp.

📦 Installation - Configure Vs Code

To make GitHub Copilot work with Spec-Coding-MCP, you first need to set up MCP server information in the relevant configuration files.

1. Visit NuGet.org, search for SpecCodingMcpServer, and you'll see the "MCP Server" tab:
2. Add a .vscode/mcp.json file to your Vs Code workspace, copy the json from the "MCP Server" tab into it, and save. Then click start above:
3. SpecCodingMcpServer requires .NET 10 to run. Please ensure you have .NET 10 installed locally (https://dotnet.microsoft.com/en-us/download/dotnet/10.0)

💻 Usage Examples - Start the Spec-Driven Development Process

1. Function Definition: Issue the instruction "Start spec coding" to GitHub Copilot, then specify the specific function, such as "Create a Vue to-do app", add relevant details, and proceed to the next step after confirmation.
2. Requirements Collection: Copilot will start the requirements collection phase, generate a requirements document in EARS format, and proceed to the design phase after confirming the requirements are correct.
3. Design Document: Based on the confirmed requirements, Copilot will generate a comprehensive technical architecture design document. Proceed to task planning after confirming the design is acceptable.
4. Task Planning: Copilot will decompose the design and requirements into a list of executable tasks, ultimately generating a complete Spec folder structure containing requirements.md, design.md, and tasks.md.
5. Task Execution: Enter the specific execution phase after confirming the task plan. Copilot will execute tasks one by one until development is complete.