
面向OpenSpec的MCP服务器——基于规范的开发,包含仪表盘和审批工作流程
概览
面向OpenSpec的MCP(模型上下文协议)服务器——基于规范的开发,支持实时仪表盘和审批工作流。 - : 作为MCP工具展示的完整OpenSpec CLI功能 - : 添加、回复、解析提案/设计的审阅意见 - : 实时解析 tasks.md 并跟踪进度 - : 请求、批准和拒绝变更提案 - : 查看单一服务项目的跨服务设计文档 - : 可视化管理界面,支持实时更新和Markdown渲染 直接利用客户的AI能力(如Claude、Codex)和上下文感知提示。 对于共享共同 .cross-service/ 目录的多业务项目(例如 Git 工作树中),请配置你的 proposal.md 前置文件: 仪表盘将显示一个“跨服务”标签页,内容包括: - :以Markdown形式渲染- :包含服务状态、变更和部署顺序的可视化卡片视图 批准记录存储在openspec/apification/.json中。
概述(AI 翻译)
面向OpenSpec的MCP(模型上下文协议)服务器——基于规范的开发,支持实时仪表盘和审批工作流。
特色
- MCP 工具:作为 MCP 工具展示的完整 OpenSpec CLI 功能
- 评审系统:添加、回复、解决对提案/设计的评审意见
- 任务跟踪:解析 tasks.md 并实时跟踪进度
- 审批流程:请求、批准和拒绝变更提案
- 跨服务文档:查看单一服务项目的跨服务设计文档
- Web 仪表盘:具备实时更新和 Markdown 渲染的可视化管理界面
快速启动
1.添加到你的MCP配置中
Claude Code CLI(推荐——使用当前目录):
Claude Code CLI with Dashboard:
Claude 代码 CLI 带有特定项目路径:
Claude桌面 / 光标 / 其他:
使用仪表盘:
2.对话中的使用
可用提示(新!)
直接利用客户的AI能力(如Claude、Codex)和上下文感知提示。
| 提示 | 描述 |
|---|---|
analyze-project |
项目架构与栈的深度分析 |
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
OpenSpec MCP
MCP (Model Context Protocol) server for OpenSpec - spec-driven development with real-time dashboard and approval workflow.
Features
- MCP Tools: Full OpenSpec CLI functionality exposed as MCP tools
- Review System: Add, reply, resolve review comments on proposals/designs
- Task Tracking: Parse tasks.md and track progress in real-time
- Approval Workflow: Request, approve, and reject change proposals
- Cross-Service Docs: View cross-service design documents from single service projects
- Web Dashboard: Visual management interface with real-time updates and Markdown rendering
Quick Start
1. Add to your MCP configuration
Claude Code CLI (recommended - uses current directory):
claude mcp add openspec -- npx openspec-mcp
Claude Code CLI with Dashboard:
claude mcp add openspec -- npx openspec-mcp --with-dashboard
Claude Code CLI with specific project path:
claude mcp add openspec -- npx openspec-mcp /path/to/your/project
Claude Desktop / Cursor / Other:
{
"mcpServers": {
"openspec": {
"command": "npx",
"args": ["-y", "openspec-mcp"]
}
}
}
With Dashboard:
{
"mcpServers": {
"openspec": {
"command": "npx",
"args": ["-y", "openspec-mcp", "--with-dashboard"]
}
}
}
2. Use in conversation
# List all changes
"List all openspec changes"
# Show change details
"Show me the add-user-auth change"
# Update task status
"Mark task 1.1 as done in add-user-auth"
# Request approval
"Request approval for add-user-auth from @reviewer"
Available Prompts (New!)
Directly leverage your Client’s AI capabilities (Claude, Codex) with context-aware prompts.
| Prompt | Description |
|---|---|
analyze-project |
Deep analysis of project architecture and stack |
review-change |
Intelligent review of changes with linked specs |
Available Tools
Guides & Context
| Tool | Description |
|---|---|
openspec_get_instructions |
Get AGENTS.md usage guide |
openspec_get_project_context |
Get project.md context |
openspec_analyze_context |
Analyze project structure & stack |
openspec_ai_analyze_context |
AI-enhanced context analysis |
Management
| Tool | Description |
|---|---|
openspec_list_changes |
List all change proposals |
openspec_list_specs |
List all specifications |
openspec_show_change |
Show change details |
安装
npx -y openspec-mcp配置
{
"mcpServers": {
"openspec": {
"command": "npx",
"args": ["-y", "openspec-mcp"]
}
}
}