OpenSpec MCP服务器（AI助手插件）
欢迎这是一个简单的桥接器（插件），用于连接 开放规范 到你最喜欢的AI编码助手（比如 IBM Bob, 法典，或 克劳德桌面).
这是什么，我为什么需要它？
当你想让你的人工智能构建一个新功能时，你通常只需在聊天中输入即可。但随着项目的增长，人工智能可能会忘记事情、感到困惑或编写混乱的代码。
开放规范 是一个解决这个问题的系统。它迫使AI在编写任何代码之前创建一个明确的“规范”（计划）。它将你的计划整理到整洁的文件夹中(proposal, design, tasks)这样你就可以复习了。
然而，你的AI不会自动知道如何使用OpenSpec。 这就是这个服务器所做的！ 它为您的AI提供了自动创建这些文件夹、列出任务并在为您编写代码时将其标记为完成所需的“工具”。
如何连接你的AI
要使用此功能，您需要告诉您的AI助手此服务器的位置。设置完全取决于您使用的AI助手。
选项1：连接到IBM Bob
如果你正在使用 IBM Bob:
- 在IBM Bob IDE中，单击 三个点 在聊天窗口右上角的齿轮图标旁边，选择 MCP服务器.
- 点击 打开 在“全局MCP”旁边编辑您的设置文件（通常保存在
~/.bob/settings/mcp_settings.json). - 添加
openspec服务器到mcpServers对象：```json
{
"mcpServers": {
"openspec": {
"command": "npx",
"args": [
"-y",
"@igor-olikh/openspec-mcp-server"
]
}
}
}
4. 保存文件并重新启动IBM Bob！
### 选项2：连接到Codex
Codex有一个内置的用户界面，可以轻松添加这些插件。
您可以通过运行以下终端命令快速添加它：```bash
codex mcp add openspec-server npx -y @igor-olikh/openspec-mcp-server
或者，通过Codex用户界面手动操作：
- 打开 “连接到自定义MCP” Codex中的盒子。
- 名字:
openspec - 模式：保留为
STDIO - 启动命令:
npx - 参数：单击
+ Add argument两次并精确粘贴：
- 第一个论点：-y
- 第二个论点：@igor-olikh/openspec-mcp-server - 工作目录：把这个留空！（这允许Codex在您当前打开的任何项目中动态使用OpenSpec）。
- 救救它！
选项3：连接到Claude桌面应用程序
如果您更喜欢使用Claude Desktop应用程序：
- 打开您的Claude配置文件（通常位于
~/Library/Application Support/Claude/claude_desktop_config.json在Mac上）。 -
添加
openspec服务器到它：json { "mcpServers": { "openspec": { "command": "npx", "args": [ "-y", "@igor-olikh/openspec-mcp-server" ] } } } -
保存文件并重新启动Claude Desktop。
我该如何使用它？
连接后，您无需进行任何技术操作。你只需像往常一样与你的AI对话，但要求它使用OpenSpec！
聊天提示示例：
- “嘿，鲍勃，我想给这个应用程序添加一个暗模式功能。请使用OpenSpec提出并验证它。”
- “我们当前项目的OpenSpec状态如何？”
- “列出我们目前正在进行的所有OpenSpec更改。”
AI将自动使用下面的工具来处理其余的事情！
面向开发者（幕后）
此服务器公开官方 @fission-ai/openspec CLI命令作为模型上下文协议（MCP）JSON-RPC工具。
可用的AI工具：
openspec_init：在项目中启动OpenSpec。openspec_new_change：为新功能方案创建文件夹。openspec_status：检查功能完成了多少。openspec_validate：检查代码是否与计划匹配。openspec_archive：将该功能标记为100%完成。openspec_list：显示所有当前任务。openspec_show：读取特定任务。openspec_update：更新OpenSpec规则。openspec_instructions：阅读AI说明以构建计划的各个部分。openspec_read_file：直接按名称和文件类型读取任何规范工件——比show，没有子流程开销。openspec_refresh_cache：如果文件在OpenSpec工具之外更改，则强制刷新缓存目录列表。
内置提示：
openspec_kickoff：一个预先制作的提示，从第一轮开始就将人工智能引导到一个严格的规范驱动的工作流程中。在AI助手的支持下自动注射。
开发设置
如果要修改此服务器的代码：
npm install（安装依赖项）npm run build（编译代码）npm run start（运行服务器以测试标准输入/输出）
最近的更改
- 内置MCP提示：The
openspec_kickoffprompt会自动引导你的人工智能从第一轮开始就进入严格的规范驱动的工作流程。 - 带内存缓存的直接文件读取器新
openspec_read_file该工具直接通过文件系统读取规范工件，绕过CLI子流程开销。目录结构的内存缓存用于list查询时间在1ms以内。任何变异操作后缓存都会自动刷新。
即将推出的功能（计划通过OpenSpec）
- 结构化JSON输出用解析的JavaScript对象替换原始终端输出，防止AI误读状态并减少幻觉。
- 智能错误处理：在OpenSpec验证失败时指导LLM（例如拦截终端错误以输出： “嘿，你忘了design.md中的'Tasks'标头”).
