LO

lumiaqian/openspec-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

31 stars 5 forks 质量 68 趋势 11MIT

面向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
在 GitHub 查看完整 README

安装

npx -y openspec-mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "openspec": { "command": "npx", "args": ["-y", "openspec-mcp"] } } }