Spec Kit MCP Server

How to use

You interact with the Spec Kit MCP Server through an MCP client. Add the MCP server configuration to your client so it can start and communicate with the server, then ask the AI to guide you through principles, templates, planning, tasks, and implementation steps. The server exposes tools that correspond to the Spec Kit workflow: Constitution, Specify, Plan, Tasks, and Implement. Use these tools in sequence to establish project principles, describe what to build, analyze the project to form a plan, break that plan into actionable tasks, and obtain concrete implementation guidelines.

How to install

Prerequisites: you must have Node.js and a compatible package manager installed on your system. You will also need a client that supports MCP configurations.

# Prerequisites
node -v
npm -v

# Optional: ensure you have uvx or your preferred tool manager installed for MCP tooling
uv --version || true

How to set up the MCP server in your client

Configure your MCP client to connect to the Spec Kit MCP Server by adding a stdio-based server entry. This uses npx to run the MCP package directly without a local install. The client will invoke the MCP server when you trigger Spec Kit workflows.

{
  "mcpServers": {
    "spec-kit": {
      "command": "npx",
      "args": [
        "-y",
        "@anyicode/spec-kit-mcp@latest"
      ]
    }
  }
}

Usage patterns with the client

Use the Spec Kit MCP Server to drive the following lifecycle: establish project principles with Constitution, collect requirements with Specify, generate a technical plan with Plan, break the plan into tasks with Tasks, and receive concrete implementation guidance with Implement. You can run these steps in sequence or jump to a specific step as your project evolves.

Notes

The server automatically detects and uses the commands directory in your project root to access Spec Kit templates, so place your templates in the expected location to ensure smooth operation.

Constitution

Establish and review project principles such as code quality and testing to align the team on expectations.

Specify

Combine templates with user requirements to describe what to build, creating a precise scope for the project.

Plan

Analyze the project and generate a technical plan that outlines architecture, milestones, and risk considerations.

Tasks

Break down the plan into actionable tasks with clear owners and deadlines.

Implement

Provide practical implementation guidelines to convert the plan into working code and deliverables.