Spec Kit MCP

🚀 Spec Kit MCP 服务器

这是一个用于 Spec Kit 的模型上下文协议（MCP）服务器。它允许 AI 助手直接与 Spec Kit 模板和工作流进行交互，以帮助管理项目规范、规划和实施。

🚀 快速开始

前提条件

在使用此 MCP 服务器之前，你必须在系统上安装 specify-cli。

持久安装（推荐）

安装一次，随处使用：

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

然后直接使用该工具：

specify init <PROJECT_NAME>
specify check

要升级 Specify，请参阅升级指南以获取详细说明。快速升级命令如下：

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

与 MCP 客户端一起使用（例如，Claude Desktop、Cursor）

你可以使用 npx 直接运行此服务器。在你的 MCP 客户端设置中添加以下配置：

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

✨ 主要特性

此服务器提供提示和工具，引导 AI 完成 Spec Kit 工作流：

• 章程 (speckit.constitution)：建立或审查项目原则（代码质量、测试等）。
• 规范 (speckit.specify)：将模板与用户需求相结合，描述要构建的内容。
• 规划 (speckit.plan)：分析项目并创建技术计划。
• 任务 (speckit.tasks)：将计划分解为可执行的任务。
• 实施 (speckit.implement)：提供实施指南。

服务器会自动检测并使用项目根目录下的 commands/ 目录来访问这些模板。

📦 安装指南

持久安装（推荐）

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

快速升级

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

与 MCP 客户端配置

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

💻 使用示例

基础用法

持久安装

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

使用工具

specify init <PROJECT_NAME>
specify check

快速升级

uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git

MCP 客户端配置

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

📚 详细文档

发布新版本

要发布此软件包的新版本，请按照以下步骤操作：

1. 更新软件包版本（例如，补丁、小版本、大版本）：

npm version patch

2. 构建项目：

npm run build

3. 将软件包发布到 npm：

npm publish --access public

4. 验证软件包是否已发布：

npm view @anyicode/spec-kit-mcp