MCP Spec Kit for Kiro CLI

An MCP (Model Context Protocol) server that exposes Spec Kit prompts for use with Kiro CLI and other MCP-compatible clients.

Overview

This MCP server automatically bootstraps Spec Kit prompts and exposes them via the Model Context Protocol. Built using FastMCP following AWS best practices.

Quick Start

1. Install the MCP Server

uv tool install --from git+https://github.com/sigent-amazon/mcp-spec-kit-kiro-cli.git mcp-speckit-kiro

2. Configure Kiro CLI

Option A: Using Command Line (Recommended)

kiro-cli mcp add \
  --name "speckit" \
  --scope global \
  --command "mcp-speckit-kiro"

Option B: Manual Configuration

Add to ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "speckit": {
      "command": "mcp-speckit-kiro",
      "args": [],
      "env": {},
      "timeout": 0,
      "disabled": false,
      "disabledTools": []
    }
  }
}

For workspace-specific configuration, create .kiro/settings/mcp.json in your project root with the same structure.

3. Use in Kiro CLI

kiro-cli chat

# List available prompts
/prompts list

# Use prompts with @ syntax (quotes required for multi-word arguments)
@speckit/speckit.specify "Build a todo app with React"
@speckit/speckit.plan "Use TypeScript and Node.js backend"

# Single word arguments don't need quotes
@speckit/speckit.constitution

# Without arguments
@speckit/speckit.tasks
@speckit/speckit.implement

# Use tools
use the speckit_version tool
use the speckit_check tool

Note: Multi-word arguments require quotes due to Kiro's prompt parser.

4. Initialize Spec Kit Projects

When you run specify init --ai kiro, the CLI will automatically detect the MCP server and skip copying .kiro/prompts/ (prompts are served by MCP instead).

Available Prompts

All prompts use the speckit. prefix to match file naming conventions:

• speckit.constitution - Create or update project governing principles
• speckit.specify - Define what you want to build (requirements and user stories)
• speckit.clarify - Clarify underspecified areas in requirements
• speckit.plan - Create technical implementation plans with your chosen tech stack
• speckit.tasks - Generate actionable task lists for implementation
• speckit.implement - Execute all tasks to build the feature according to the plan
• speckit.analyze - Cross-artifact consistency and coverage analysis
• speckit.checklist - Generate custom quality checklists for requirements validation

Usage: @speckit/speckit.specify "Your requirements here" (quotes required for multi-word arguments)

Available Tools

• speckit_version - Get the installed Spec Kit version
• speckit_check - Check Spec Kit prerequisites and installed tools

Installation

See README.md for full installation and configuration details.

Docker

# Build and run
docker-compose up -d

# View logs
docker-compose logs -f

Development

# Local development with Spec Kit source
export SPECKIT_SOURCE=/path/to/spec-kit
mcp-speckit-kiro

License

MIT