Spec-Kit MCP Server

MCP server that enables AI coding assistants to use spec-driven development practices via the GitHub Spec-Kit toolkit.

Features

• 🎯 100% Spec-Kit Coverage: All 10 tools for complete spec-driven development
• 🚀 MCP Protocol: Full JSON-RPC 2.0 implementation for AI agents
• ⚡ High Performance: Built with Rust and Tokio for async I/O
• 🔧 Dual Installation: Install via cargo or npx
• 🛡️ Type Safe: Comprehensive type system with validation
• 📚 Comprehensive Docs: Tutorials, examples, and configuration guides
• 🌐 Multi-Editor Support: Claude Code, Cursor, Windsurf, VS Code, and more
• 🧪 Production Ready: Tested, documented, and deployed

Quick Start

Installation

Via Cargo (Recommended)

Fast, reliable, works offline:

cargo install spec-kit-mcp

Advantages:

• ✅ Fastest startup
• ✅ Works offline
• ✅ Most reliable
• ✅ Full platform support (macOS Intel/ARM, Linux)

Via npm/npx

For Node.js users:

# Global installation
npm install -g @lsendel/spec-kit-mcp

# Or use with npx (downloads on first use)
npx @lsendel/spec-kit-mcp

Advantages:

• ✅ Familiar for Node.js users
• ✅ Auto-downloads prebuilt binaries
• ✅ npx always uses latest version

Prerequisites

• Python 3.11+: Required by GitHub spec-kit
• uv package manager: Required to run spec-kit (install from https://docs.astral.sh/uv/)
• GitHub Spec-Kit: No separate installation needed - the MCP server uses uvx to run spec-kit directly
• Node.js 18+: Only if using npx installation method
• Git: For version control operations

Note: The spec-kit CLI is not available on PyPI. The MCP server automatically runs it via uvx --from git+https://github.com/github/spec-kit.git

Configuration with Claude Code

Claude Code supports two ways to configure MCP servers:

Method 1: Using Cargo Binary (Recommended)

First install via cargo:

cargo install spec-kit-mcp

Then configure ~/.config/claude-code/mcp.json:

{
  "mcpServers": {
    "spec-kit": {
      "command": "spec-kit-mcp",
      "args": [],
      "env": {}
    }
  }
}

Advantages:

• ✅ Fastest startup (<100ms)
• ✅ Works offline
• ✅ Most reliable
• ✅ Supports all platforms (macOS Intel/ARM, Linux)

Method 2: Using npx (No Installation)

Create or edit ~/.config/claude-code/mcp.json:

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

Advantages: