
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
cargoornpx - 🛡️ 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
uvxto 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:
安装
npx -y @lsendel/spec-kit-mcp配置
{
"mcpServers": {
"spec-kit": {
"command": "spec-kit-mcp",
"args": [],
"env": {}
}
}
}