LS

lsendel/spec-kit-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

32 stars 6 forks 质量 66 趋势 11Apache-2.0

MCP服务器使AI助手能够使用GitHub的spec-kit方法论

概览

- : 全部10个工具,支持完整的规范驱动开发 - : 为AI代理实现完整的JSON-RPC 2.0 - : 采用Rust和Tokio构建的异步I/O- : 通过货运或npx安装 - : 带验证的全面类型系统 - : 教程、示例和配置指南 - : Claude代码、光标、Windsurf、VS Code等 - : 已测试、文档化并部署 - ✅ 启动最快 - ✅ 离线运行 - ✅ 最可靠 - ✅ 全平台支持(macOS Intel/ARM,Linux) - ✅ Node.js用户熟悉版 - ✅ 自动下载预构建的二进制文件 - ✅ npx始终使用最新版本 - : GitHub spec-kit 要求 - : 运行 spec-kit 必须(从 https://docs.astral.sh/uv/) 安装) - : 无需单独安装 - MCP 服务器使用 uvx 直接运行 spec-kit - : 仅在使用 npx 安装方法时 - : 用于版本控制操作 : spec-kit CLI 在 PyPI 上不可用。MCP 服务器会自动通过 uvx 运行 ---from git+https://github.com/github/spec-kit.

概述(AI 翻译)

MCP服务器,使AI编码助手能够通过GitHub Spec-Kit工具包使用基于规范的开发实践。

特色

  • ** 🎯 100% 规格套件覆盖**:全部10种工具,支持完整的规格驱动开发
  • ** 🚀 MCP 协议**:AI 代理的完整 JSON-RPC 2.0 实现
  • ** ⚡ 高性能**:采用Rust和Tokio构建异步输入输出
  • ** 🔧 双重安装**:通过cargo或[[T1])安装]
  • ** 🛡️ 类型安全**:带验证的综合类型系统
  • ** 📚 综合文档**:教程、示例和配置指南
  • ** 🌐 多编辑器支持**:Claude Code、光标、Windsurf、VS Code 等
  • ** 🧪 生产准备**:已测试、文档并部署

快速启动

安装

通过货运(推荐)

快速、可靠、离线运行:

优势:

  • ✅ 启动最快
  • ✅ 离线运行
  • ✅ 最可靠
  • ✅ 全平台支持(macOS Intel/ARM,Linux)

来自 npm/npx

对于Node.js用户:

优势:

  • ✅ Node.js用户熟悉版
  • ✅ 自动下载预建二进制文件
  • ✅ NPX 始终使用最新版本

先决条件

  • Python 3.11+:GitHub spec-kit 要求

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

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

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:

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:

在 GitHub 查看完整 README

安装

npx -y @lsendel/spec-kit-mcp
新手?先看 mcpskill.org 教程 →

配置

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