Spec-driven Development

You can run an AI-guided, spec-driven development workflow as an MCP server to guide you from goal definition through requirements, design, tasks, and execution. This server helps you plan, document, and track development with structured, template-based guidance and automatic progress updates.

How to use

You can use the spec-driven development MCP server with an MCP client such as Claude Desktop, Cursor, or any MCP-compatible tool. The workflow guides you through five stages: goal collection, requirements gathering, design, task planning, and task execution. Use it to transform high-level ideas into concrete, testable specifications and an actionable implementation plan.

How to install

Prerequisites you need on your machine: Node.js 18+ and a modern package manager (npm or pnpm). Ensure you have internet access to install and run MCP components.

# Option A: Install the MCP server client via Smithery for Claude integration
npx -y @smithery/cli install @kevinlin/spec-coding-mcp --client claude

# Option B: Run the MCP server directly with npx to fetch the latest version
npx spec-coding-mcp@latest

# Or simply (also fetches latest)
npx spec-coding-mcp
```} ,{

Using the MCP server with a client

To connect a Cursor-style MCP client, add the server configuration under mcpServers. Use the runtime command shown below to start the server locally. The configuration uses a stdio (local) runtime with the npx command to execute the MCP server package.

{
  "mcpServers": {
    "spec-coding-mcp": {
      "command": "npx",
      "args": ["spec-coding-mcp@latest"],
      "env": {},
      "disabled": false
    }
  }
}
```}]} ,{

Additional notes and tips

The server exposes a set of tools to manage the workflow stages. You can start the workflow, confirm goals and requirements, begin design and task planning, and initiate execution. Use the provided tool endpoints through your MCP client to drive each stage and keep a structured record of decisions and artifacts.

Available tools

spec_coding_workflow_start

Start the development workflow and begin the sequence of guided steps.

spec_coding_goal_confirmed

Confirm the defined feature goals and record the outcome for the project scope.

spec_coding_requirements_start

Begin gathering detailed requirements in EARS format for the feature.

spec_coding_requirements_confirmed

Confirm completion of requirements collection and lock the scope.

spec_coding_design_start

Create the technical design and architecture documentation.

spec_coding_design_confirmed

Confirm design completion and readiness to implement.

spec_coding_tasks_start

Break down the work into executable tasks with dependencies.

spec_coding_tasks_confirmed

Confirm the task plan and ready the execution phase.

spec_coding_execute_start

Begin implementing the tasks to deliver the feature.