Spec MCP 服务器
一种模型上下文协议服务器，旨在通过人工智能辅助的分析、规划和验证来简化开发工作流程。
特点/特性
- 技术指导/技术引领自动化代码库分析与文档生成
- 计划生成全面的需求和设计文档
- 任务分解带有依赖关系的详细任务生成
- 实施验证自动化代码审查和合规性检查
安装
- 配置您的AI客户端（Claude Desktop、Cursor等）
- 将服务器添加到您的MCP配置中
- 开始通过你的AI界面使用这些工具
配置示例
Visual Studio Code
在你的 VS Code MCP 配置文件中添加：
- 常规的VS Code：
~/Library/Application Support/Code/User/mcp.json - VS Code Insiders（内测版）：
~/Library/Application Support/Code - Insiders/User/mcp.json
{
"servers": {
"spec": {
"command": "npx",
"args": [
"-y",
"spec-mcp@latest"
]
}
}
}泽德
- 打开Zed > 设置 > 打开设置（它将打开
~/. config/zed/settings.json) - 在您的配置中添加一个 context_servers 部分：
{
"context_servers": {
"spec": {
"source": "custom",
"command": "npx",
"args": ["-y", "spec-mcp@latest"],
"env": {}
}
}
}克劳德代码（CLI）
对于 Claude Code CLI，请使用以下命令：
claude mcp add spec-mcp --scope user -- npx -y spec-mcp@latestClaude Desktop（可译为“Claude桌面版”或保持原样，若“Claude”是特定软件或系统的名称，则通常不翻译，直接保留原名）
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"spec": {
"command": "npx",
"args": [
"-y",
"spec-mcp@latest"
]
}
}
}工作流程
Spec MCP工作流程将引导您完成复杂的开发任务，如框架迁移、功能实现或重构。请按照以下步骤操作：
1. 分析代码库（一次性设置）
分析现有的代码库，以创建指导未来所有操作的指导性文件。
提示： Use Spec MCP to analyze the codebase
这会产生三个指导性文件 .spec/steering/：
product.md- 产品概述及业务背景tech.md- 技术栈和开发指南structure.md- 项目组织和模式
*注：您可以随时使用（相关工具/方法）重新创建这些文档 force_regenerate=true*
2. 搜索文档
使用例如Context7 MCP等工具，在文档中搜索有关框架、API或迁移指南的相关信息。
提示： Search docs with Context7 MCP for [topic/framework/library]
3. 生成任务
请Spec MCP服务器根据您的目标生成一个清晰、基于证据的任务列表。
在上下文窗口中有您之前的分析后，您可以基于此创建任务。
示例提示：
Generate tasks from the analysis using Spec MCP
输出：
.spec/specs/tasks.md（包括概述、与EARS相关的要求、可执行的任务、依赖项以及测试）
4. 执行任务
使用任务编排器系统地执行任务，该编排器负责处理任务依赖和并行化。
提示： Implement tasks from tasks.md using Spec MCP task orchestrator
协调器将：
- 根据依赖关系确定可执行任务
- 通过任务执行器执行任务
- 使用任务检查器验证完成情况
- 报告进度及接下来可执行的任务
可用工具
生成代码库分析
分析代码库，并在.spec/steering/目录下生成三份基础分析文档：product.md、tech.md 和 structure.md。这些文档对产品功能、技术栈和项目结构进行了全面分析。
生成任务
规格MCP：生成tasks.md（计划与任务分解）
根据你的需求和代码库生成 tasks.md（实施计划和任务分解）。撰写 .spec/specs/tasks.md 包含概览、使用EARS（可能指某种需求管理或评估系统）的编号需求、可实施的任务（T-1…）、依赖关系/阶段以及测试指南。可用于“任务分解”、“创建tasks.md文件”、“实施计划”或“路线图”。输入内容：
user_request（必填）project_path（可选，默认为.)
任务协调器
分析tasks.md文件以识别依赖关系、并行化机会，并协调任务执行。返回一个结构化的执行计划，以高效部署任务执行器。
任务执行器
通过提供详细的实现指南、要求、验收标准和代码模式，执行tasks.md中的特定任务。此工具专注于彻底完成一项任务的实现。
任务检查器
检查任务是否可以标记为完成，方法是验证所有验收标准复选框是否已被勾选，并可选择性地运行构建/测试。返回“通过”或“失败”以及明确的原因。
许可证
麻省理工学院（MIT）