{"_id":"@al76/tools-and-spec-workflow-mcp","_rev":"5-947b79dedbb639f3c8a0eecdba484c49","name":"@al76/tools-and-spec-workflow-mcp","dist-tags":{"latest":"0.0.37"},"versions":{"0.0.33":{"name":"@al76/tools-and-spec-workflow-mcp","version":"0.0.33","keywords":["mcp","model-context-protocol","spec-workflow","ai-development","claude","cursor","development-workflow","project-management"],"author":"","license":"GPL-3.0","_id":"@al76/tools-and-spec-workflow-mcp@0.0.33","maintainers":[{"name":"al76","email":"yitongstudy@hotmail.com"}],"bin":{"spec-workflow-mcp":"dist/index.js"},"dist":{"shasum":"8efdc8f2858f16585ef79308870098e441c4700d","tarball":"https://registry.npmjs.org/@al76/tools-and-spec-workflow-mcp/-/tools-and-spec-workflow-mcp-0.0.33.tgz","fileCount":213,"integrity":"sha512-ShVdzAUn32XG93iQVYIWgZTtDoEm1ilHzpA8SgYyk4eCropXosnhGb+jhOpoA7rHN2DoZ8brotTBtaZchdLkvA==","signatures":[{"sig":"MEUCIQDX+6mPFZXkyaPWEWCZTIqepGBbVhyhCnbzmQzWY+YMjAIgVzao+69QZU1EtIlymOxMKC0nWjW67CFhse7sYuXBWcM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4699666},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"46074a491a376417b4390a6018ee7f5c80e9667f","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"npm run validate:i18n && npm run clean && tsc && npm run build:dashboard && npm run copy-static","clean":"rimraf dist","start":"node dist/index.js","test:watch":"vitest --watch","copy-static":"node scripts/copy-static.cjs","dev:dashboard":"vite --config src/dashboard_frontend/vite.config.ts","test:coverage":"vitest --coverage","validate:i18n":"node scripts/validate-i18n.js","prepublishOnly":"npm run build","build:dashboard":"vite build --config src/dashboard_frontend/vite.config.ts"},"_npmUser":{"name":"al76","email":"yitongstudy@hotmail.com"},"_npmVersion":"10.8.2","description":"MCP server for spec-driven development workflow with real-time web dashboard","directories":{},"_nodeVersion":"20.19.4","dependencies":{"clsx":"^2.1.1","open":"^8.4.2","toml":"^3.0.0","react":"^18.3.1","fastify":"^4.24.3","i18next":"^25.5.2","mermaid":"^10.9.1","chokidar":"^3.5.3","react-dom":"^18.3.1","simple-git":"^3.28.0","markdown-it":"^14.1.0","highlight.js":"^11.9.0","react-i18next":"^15.7.3","@fastify/static":"^7.0.4","react-router-dom":"^6.26.2","@fastify/websocket":"^8.2.1","@modelcontextprotocol/sdk":"^0.5.0","i18next-browser-languagedetector":"^8.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","vite":"^5.4.8","rimraf":"^6.0.1","vitest":"^2.1.8","postcss":"^8.4.47","@types/ws":"^8.5.13","typescript":"^5.7.2","@types/node":"^22.18.1","tailwindcss":"^3.4.10","@types/react":"^18.3.5","autoprefixer":"^10.4.20","@types/react-dom":"^18.3.0","@vitest/coverage-v8":"^2.1.8","@vitejs/plugin-react":"^4.3.3","@tailwindcss/typography":"^0.5.16"},"_npmOperationalInternal":{"tmp":"tmp/tools-and-spec-workflow-mcp_0.0.33_1758184301090_0.6163076241435206","host":"s3://npm-registry-packages-npm-production"}},"0.0.34":{"name":"@al76/tools-and-spec-workflow-mcp","version":"0.0.34","keywords":["mcp","model-context-protocol","spec-workflow","ai-development","claude","cursor","development-workflow","project-management"],"author":"","license":"GPL-3.0","_id":"@al76/tools-and-spec-workflow-mcp@0.0.34","maintainers":[{"name":"al76","email":"yitongstudy@hotmail.com"}],"bin":{"spec-workflow-mcp":"dist/index.js"},"dist":{"shasum":"9693ca498642dbf11bc78f560e5ff8dcb7a5eaf1","tarball":"https://registry.npmjs.org/@al76/tools-and-spec-workflow-mcp/-/tools-and-spec-workflow-mcp-0.0.34.tgz","fileCount":213,"integrity":"sha512-oSLBxLnvQ2BBOkUBlw4fMHBKQWkuOm32XREMMb72s9SAN1/FN8DKFBvLsrthDhw09UUa4R5ggtFD6CUMWXSAKg==","signatures":[{"sig":"MEUCIEdxzKob2rrllN7sXXUEPfwfdjVarhJlA2WkoFqf++HEAiEA0MwZB7ATsmCulRvalt54ISCE0pipchNda1hKwLOF0BE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4699666},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"22bd06b668589fe199c4929ef6aaf696d8d71381","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"npm run validate:i18n && npm run clean && tsc && npm run build:dashboard && npm run copy-static","clean":"rimraf dist","start":"node dist/index.js","test:watch":"vitest --watch","copy-static":"node scripts/copy-static.cjs","dev:dashboard":"vite --config src/dashboard_frontend/vite.config.ts","test:coverage":"vitest --coverage","validate:i18n":"node scripts/validate-i18n.js","prepublishOnly":"npm run build","build:dashboard":"vite build --config src/dashboard_frontend/vite.config.ts"},"_npmUser":{"name":"al76","email":"yitongstudy@hotmail.com"},"_npmVersion":"10.8.2","description":"MCP server for spec-driven development workflow with real-time web dashboard","directories":{},"_nodeVersion":"20.19.4","dependencies":{"clsx":"^2.1.1","open":"^8.4.2","toml":"^3.0.0","react":"^18.3.1","fastify":"^4.24.3","i18next":"^25.5.2","mermaid":"^10.9.1","chokidar":"^3.5.3","react-dom":"^18.3.1","simple-git":"^3.28.0","markdown-it":"^14.1.0","highlight.js":"^11.9.0","react-i18next":"^15.7.3","@fastify/static":"^7.0.4","react-router-dom":"^6.26.2","@fastify/websocket":"^8.2.1","@modelcontextprotocol/sdk":"^0.5.0","i18next-browser-languagedetector":"^8.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","vite":"^5.4.8","rimraf":"^6.0.1","vitest":"^2.1.8","postcss":"^8.4.47","@types/ws":"^8.5.13","typescript":"^5.7.2","@types/node":"^22.18.1","tailwindcss":"^3.4.10","@types/react":"^18.3.5","autoprefixer":"^10.4.20","@types/react-dom":"^18.3.0","@vitest/coverage-v8":"^2.1.8","@vitejs/plugin-react":"^4.3.3","@tailwindcss/typography":"^0.5.16"},"_npmOperationalInternal":{"tmp":"tmp/tools-and-spec-workflow-mcp_0.0.34_1758184487010_0.1895700154958464","host":"s3://npm-registry-packages-npm-production"}},"0.0.35":{"name":"@al76/tools-and-spec-workflow-mcp","version":"0.0.35","keywords":["mcp","model-context-protocol","spec-workflow","ai-development","claude","cursor","development-workflow","project-management"],"author":"","license":"GPL-3.0","_id":"@al76/tools-and-spec-workflow-mcp@0.0.35","maintainers":[{"name":"al76","email":"yitongstudy@hotmail.com"}],"bin":{"spec-workflow-mcp":"dist/index.js"},"dist":{"shasum":"306ae2e632dd2ea8a510c6f3173cd7074f3e05c4","tarball":"https://registry.npmjs.org/@al76/tools-and-spec-workflow-mcp/-/tools-and-spec-workflow-mcp-0.0.35.tgz","fileCount":213,"integrity":"sha512-1BuxHtD6JiiBpwCEizNgD3Vn7bvQyzArZ+TpjxllHgyZhvH3L+y0DFx76a0jJkwSiNTLPASVb3qiiLj9e+4beA==","signatures":[{"sig":"MEUCIDKvu0vT0nzqPFJWTFNkCxsnBQdz79vzjcBzfecgikLTAiEAsuURgl2Fu63LiMIygYFgM5xg9dI+fOVYLj/OxWOGysU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4694672},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"2bfcad526cd38e8dbf4926d1d64a5b9137edf033","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"npm run validate:i18n && npm run clean && tsc && npm run build:dashboard && npm run copy-static","clean":"rimraf dist","start":"node dist/index.js","test:watch":"vitest --watch","copy-static":"node scripts/copy-static.cjs","dev:dashboard":"vite --config src/dashboard_frontend/vite.config.ts","test:coverage":"vitest --coverage","validate:i18n":"node scripts/validate-i18n.js","prepublishOnly":"npm run build","build:dashboard":"vite build --config src/dashboard_frontend/vite.config.ts"},"_npmUser":{"name":"al76","email":"yitongstudy@hotmail.com"},"_npmVersion":"10.8.2","description":"MCP server for spec-driven development workflow with real-time web dashboard","directories":{},"_nodeVersion":"20.19.4","dependencies":{"clsx":"^2.1.1","open":"^8.4.2","toml":"^3.0.0","react":"^18.3.1","fastify":"^4.24.3","i18next":"^25.5.2","mermaid":"^10.9.1","chokidar":"^3.5.3","react-dom":"^18.3.1","simple-git":"^3.28.0","markdown-it":"^14.1.0","highlight.js":"^11.9.0","react-i18next":"^15.7.3","@fastify/static":"^7.0.4","react-router-dom":"^6.26.2","@fastify/websocket":"^8.2.1","@modelcontextprotocol/sdk":"^0.5.0","i18next-browser-languagedetector":"^8.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","vite":"^5.4.8","rimraf":"^6.0.1","vitest":"^2.1.8","postcss":"^8.4.47","@types/ws":"^8.5.13","typescript":"^5.7.2","@types/node":"^22.18.1","tailwindcss":"^3.4.10","@types/react":"^18.3.5","autoprefixer":"^10.4.20","@types/react-dom":"^18.3.0","@vitest/coverage-v8":"^2.1.8","@vitejs/plugin-react":"^4.3.3","@tailwindcss/typography":"^0.5.16"},"_npmOperationalInternal":{"tmp":"tmp/tools-and-spec-workflow-mcp_0.0.35_1758188328982_0.605610125452493","host":"s3://npm-registry-packages-npm-production"}},"0.0.36":{"name":"@al76/tools-and-spec-workflow-mcp","version":"0.0.36","keywords":["mcp","model-context-protocol","spec-workflow","ai-development","claude","cursor","development-workflow","project-management"],"author":"","license":"GPL-3.0","_id":"@al76/tools-and-spec-workflow-mcp@0.0.36","maintainers":[{"name":"al76","email":"yitongstudy@hotmail.com"}],"bin":{"spec-workflow-mcp":"dist/index.js"},"dist":{"shasum":"0eb9ece6337df0fd63a58c8399fe2702bc15f24d","tarball":"https://registry.npmjs.org/@al76/tools-and-spec-workflow-mcp/-/tools-and-spec-workflow-mcp-0.0.36.tgz","fileCount":213,"integrity":"sha512-s9duNPYzocc4rwG5ITOVkGIZXHRNzzZMizTB7Qc58zG8nKiG0IMGlcsshMQ53An1EVweKvp1l0YJC/50VDBabw==","signatures":[{"sig":"MEUCIQDT+BGlHFiGQoF/HMawP44vbVtfMLeC2EuRyDbUen1PWwIgdC8SXzg1y3qKntKofbgRPNN3pZ9DEOQJAPDvkHiM7oE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4691706},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"acc311fe747b413f103cf171e73f9fdd9053a1f8","scripts":{"dev":"tsx src/index.ts","test":"vitest","build":"npm run validate:i18n && npm run clean && tsc && npm run build:dashboard && npm run copy-static","clean":"rimraf dist","start":"node dist/index.js","test:watch":"vitest --watch","copy-static":"node scripts/copy-static.cjs","dev:dashboard":"vite --config src/dashboard_frontend/vite.config.ts","test:coverage":"vitest --coverage","validate:i18n":"node scripts/validate-i18n.js","prepublishOnly":"npm run build","build:dashboard":"vite build --config src/dashboard_frontend/vite.config.ts"},"_npmUser":{"name":"al76","email":"yitongstudy@hotmail.com"},"_npmVersion":"10.8.2","description":"MCP server for spec-driven development workflow with real-time web dashboard","directories":{},"_nodeVersion":"20.19.4","dependencies":{"clsx":"^2.1.1","open":"^8.4.2","toml":"^3.0.0","react":"^18.3.1","fastify":"^4.24.3","i18next":"^25.5.2","mermaid":"^10.9.1","chokidar":"^3.5.3","react-dom":"^18.3.1","simple-git":"^3.28.0","markdown-it":"^14.1.0","highlight.js":"^11.9.0","react-i18next":"^15.7.3","@fastify/static":"^7.0.4","react-router-dom":"^6.26.2","@fastify/websocket":"^8.2.1","@modelcontextprotocol/sdk":"^0.5.0","i18next-browser-languagedetector":"^8.2.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","vite":"^5.4.8","rimraf":"^6.0.1","vitest":"^2.1.8","postcss":"^8.4.47","@types/ws":"^8.5.13","typescript":"^5.7.2","@types/node":"^22.18.1","tailwindcss":"^3.4.10","@types/react":"^18.3.5","autoprefixer":"^10.4.20","@types/react-dom":"^18.3.0","@vitest/coverage-v8":"^2.1.8","@vitejs/plugin-react":"^4.3.3","@tailwindcss/typography":"^0.5.16"},"_npmOperationalInternal":{"tmp":"tmp/tools-and-spec-workflow-mcp_0.0.36_1758193526185_0.855491612482681","host":"s3://npm-registry-packages-npm-production"}},"0.0.37":{"name":"@al76/tools-and-spec-workflow-mcp","version":"0.0.37","description":"MCP server for spec-driven development workflow with real-time web dashboard","main":"dist/index.js","type":"module","bin":{"spec-workflow-mcp":"dist/index.js"},"scripts":{"build":"npm run validate:i18n && npm run clean && tsc && npm run build:dashboard && npm run copy-static","copy-static":"node scripts/copy-static.cjs","dev":"tsx src/index.ts","start":"node dist/index.js","dev:dashboard":"vite --config src/dashboard_frontend/vite.config.ts","build:dashboard":"vite build --config src/dashboard_frontend/vite.config.ts","clean":"rimraf dist","validate:i18n":"node scripts/validate-i18n.js","test":"vitest","test:watch":"vitest --watch","test:coverage":"vitest --coverage","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","spec-workflow","ai-development","claude","cursor","development-workflow","project-management"],"author":"","license":"GPL-3.0","dependencies":{"@fastify/static":"^7.0.4","@fastify/websocket":"^8.2.1","@modelcontextprotocol/sdk":"^0.5.0","chokidar":"^3.5.3","clsx":"^2.1.1","fastify":"^4.24.3","highlight.js":"^11.9.0","i18next":"^25.5.2","i18next-browser-languagedetector":"^8.2.0","markdown-it":"^14.1.0","mermaid":"^10.9.1","open":"^8.4.2","react":"^18.3.1","react-dom":"^18.3.1","react-i18next":"^15.7.3","react-router-dom":"^6.26.2","simple-git":"^3.28.0","toml":"^3.0.0"},"devDependencies":{"@tailwindcss/typography":"^0.5.16","@types/node":"^22.18.1","@types/react":"^18.3.5","@types/react-dom":"^18.3.0","@types/ws":"^8.5.13","@vitejs/plugin-react":"^4.3.3","@vitest/coverage-v8":"^2.1.8","autoprefixer":"^10.4.20","postcss":"^8.4.47","rimraf":"^6.0.1","tailwindcss":"^3.4.10","tsx":"^4.7.0","typescript":"^5.7.2","vite":"^5.4.8","vitest":"^2.1.8"},"_id":"@al76/tools-and-spec-workflow-mcp@0.0.37","gitHead":"480bbd2ab15d7041e73c8b682f57c269a142c872","types":"./dist/index.d.ts","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-HuNmCG4G1AoyGYBqrKJzGVMLjNIc53Q1y2VCCaiGl55O5Ps/P3dWz/SxxtEO8F0eG/j4arnxYO1jLCPtgPwBgg==","shasum":"94fc60b537f0e91b42ed095a7dcf9d6dfa012189","tarball":"https://registry.npmjs.org/@al76/tools-and-spec-workflow-mcp/-/tools-and-spec-workflow-mcp-0.0.37.tgz","fileCount":213,"unpackedSize":4690947,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCVGD3+r6l0GB/oawTtbTNmNtj3bHGLQH+oIAdDUb9SFAIgLhDMMzgF/+vgiIe6GHcqMV+LZ6ttrjMj+o9nTnMSes4="}]},"_npmUser":{"name":"al76","email":"yitongstudy@hotmail.com"},"directories":{},"maintainers":[{"name":"al76","email":"yitongstudy@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tools-and-spec-workflow-mcp_0.0.37_1758194328000_0.2680231186542108"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-18T08:31:40.903Z","modified":"2025-09-18T11:18:48.397Z","0.0.33":"2025-09-18T08:31:41.332Z","0.0.34":"2025-09-18T08:34:47.237Z","0.0.35":"2025-09-18T09:38:49.193Z","0.0.36":"2025-09-18T11:05:26.411Z","0.0.37":"2025-09-18T11:18:48.224Z"},"license":"GPL-3.0","keywords":["mcp","model-context-protocol","spec-workflow","ai-development","claude","cursor","development-workflow","project-management"],"description":"MCP server for spec-driven development workflow with real-time web dashboard","maintainers":[{"name":"al76","email":"yitongstudy@hotmail.com"}],"readme":"# 规范工作流 MCP\n\n[![npm version](https://img.shields.io/npm/v/@al76/tools-and-spec-workflow-mcp)](https://www.npmjs.com/package/@al76/tools-and-spec-workflow-mcp)\n[![VSCode Extension](https://badgen.net/vs-marketplace/v/Pimzino.spec-workflow-mcp)](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)\n\n一个模型上下文协议（MCP）服务器，为AI辅助软件开发提供结构化的规范驱动开发工作流工具，具有实时Web仪表板和VSCode扩展，可直接在开发环境中监控和管理项目进度。\n\n## 📺 展示\n\n### 🔄 审批系统演示\n<a href=\"https://www.youtube.com/watch?v=C-uEa3mfxd0\" target=\"_blank\">\n  <img src=\"https://img.youtube.com/vi/C-uEa3mfxd0/maxresdefault.jpg\" alt=\"审批系统演示\" width=\"600\">\n</a>\n\n*了解审批系统的工作原理：创建文档、通过仪表板请求审批、提供反馈并跟踪修订。*\n\n### 📊 仪表板和规范管理\n<a href=\"https://www.youtube.com/watch?v=g9qfvjLUWf8\" target=\"_blank\">\n  <img src=\"https://img.youtube.com/vi/g9qfvjLUWf8/maxresdefault.jpg\" alt=\"仪表板演示\" width=\"600\">\n</a>\n\n*探索实时仪表板：查看规范、跟踪进度、导航文档并监控您的开发工作流。*\n\n---\n\n## 功能特性\n\n- **结构化开发工作流** - 顺序规范创建（需求 → 设计 → 任务）\n- **实时Web仪表板** - 通过实时更新监控规范、任务和进度\n- **VSCode扩展** - 为VSCode开发者提供集成侧边栏仪表板\n- **文档管理** - 从仪表板或扩展查看和管理所有规范文档\n- **归档系统** - 组织已完成的规范以保持活跃项目的整洁\n- **任务进度跟踪** - 可视化进度条和详细任务状态\n- **审批工作流** - 完整的审批流程，包括批准、拒绝和修订请求\n- **指导文档** - 项目愿景、技术决策和结构指导\n- **声音通知** - 可配置的审批和任务完成音频提醒\n- **Bug工作流** - 完整的Bug报告和解决跟踪\n- **模板系统** - 所有文档类型的预构建模板\n- **跨平台** - 支持Windows、macOS和Linux\n\n## 🌍 支持的语言\n\n整个界面（仪表板、VSCode扩展）支持以下语言：\n\n- 🇺🇸 **英语** (en)\n- 🇯🇵 **日语** (ja) - 日本語\n- 🇨🇳 **中文** (zh) - 中文\n- 🇪🇸 **西班牙语** (es) - Español\n- 🇧🇷 **葡萄牙语** (pt) - Português\n- 🇩🇪 **德语** (de) - Deutsch\n- 🇫🇷 **法语** (fr) - Français\n- 🇷🇺 **俄语** (ru) - Русский\n- 🇮🇹 **意大利语** (it) - Italiano\n- 🇰🇷 **韩语** (ko) - 한국어\n- 🇸🇦 **阿拉伯语** (ar) - العربية\n\n语言选择在仪表板和VSCode扩展设置中均可使用。\n\n## 快速开始\n\n1. **添加到您的AI工具配置中**（请参阅下面的MCP客户端设置）：\n   ```json\n   {\n     \"mcpServers\": {\n       \"spec-workflow\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"]\n       }\n     }\n   }\n   ```\n\n   **自动启动仪表板**（随MCP服务器自动打开仪表板）：\n   ```json\n   {\n     \"mcpServers\": {\n       \"spec-workflow\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\", \"--AutoStartDashboard\"]\n       }\n     }\n   }\n   ```\n\n   **自定义端口**：\n   ```json\n   {\n     \"mcpServers\": {\n       \"spec-workflow\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\", \"--AutoStartDashboard\", \"--port\", \"3456\"]\n       }\n     }\n   }\n   ```\n\n   **注意：** 可以不使用项目路径，但某些MCP客户端可能无法从当前目录启动服务器。\n\n2. **选择您的界面**：\n\n   ### 选项A：Web仪表板（**CLI用户必需**）\n   ```bash\n   # 仅仪表板模式（使用临时端口）\n   npx -y @al76/tools-and-spec-workflow-mcp@latest /path/to/your/project --dashboard\n\n   # 仅仪表板模式，自定义端口\n   npx -y @al76/tools-and-spec-workflow-mcp@latest /path/to/your/project --dashboard --port 3000\n\n   # 查看所有可用选项\n   npx -y @al76/tools-and-spec-workflow-mcp@latest --help\n   ```\n\n   **命令行选项：**\n   - `--help` - 显示全面的使用信息和示例\n   - `--dashboard` - 运行仅仪表板模式（无MCP服务器）\n   - `--AutoStartDashboard` - 随MCP服务器自动启动仪表板\n   - `--port <number>` - 指定仪表板端口（1024-65535）。与`--dashboard`和`--AutoStartDashboard`都兼容\n   - `--config <path>` - 使用自定义配置文件而不是默认位置。支持相对路径和绝对路径\n\n   **配置文件：**\n   \n   您可以使用TOML配置文件来配置服务器。默认情况下，服务器会查找`<project-dir>/.spec-workflow/config.toml`，但您可以使用`--config`标志指定自定义位置。\n\n   配置示例：\n   ```toml\n   # 项目目录（默认为当前目录）\n   projectDir = \"/path/to/your/project\"\n   \n   # 仪表板端口（1024-65535）\n   port = 3456\n   \n   # 随MCP服务器自动启动仪表板\n   autoStartDashboard = true\n   \n   # 运行仅仪表板模式\n   dashboardOnly = false\n   \n   # 界面语言（en, ja, zh, es, pt, de, fr, ru, it, ko, ar）\n   lang = \"en\"\n   ```\n\n   **使用自定义配置文件：**\n   ```bash\n   # 使用自定义配置文件\n   npx @al76/tools-and-spec-workflow-mcp --config ~/my-configs/spec.toml\n   \n   # 自定义配置与仪表板\n   npx @al76/tools-and-spec-workflow-mcp --config ./dev-config.toml --dashboard\n   \n   # CLI参数仍会覆盖自定义配置\n   npx @al76/tools-and-spec-workflow-mcp --config ./config.toml --port 4000\n   ```\n\n   **配置优先级：**\n   1. 命令行参数（最高优先级）\n   2. 自定义配置文件（如果使用--config指定）\n   3. 默认配置文件（.spec-workflow/config.toml）\n   4. 内置默认值（最低优先级）\n\n   完整的配置示例文件及文档可在`.spec-workflow/config.example.toml`中找到。\n\n   ### 选项B：VSCode扩展（**推荐VSCode用户使用**）\n\n   从VSCode市场安装**[规范工作流MCP扩展](https://marketplace.visualstudio.com/items?itemName=Pimzino.spec-workflow-mcp)**：\n\n   1. 在包含`.spec-workflow/`的项目目录中打开VSCode\n   2. 扩展会自动在VSCode内提供仪表板功能\n   3. 通过活动栏中的规范工作流图标访问\n   4. **无需单独的仪表板** - 一切都在您的IDE内运行\n\n   **扩展功能：**\n   - 集成侧边栏仪表板，具有实时更新\n   - 用于组织已完成规范的归档系统\n   - 使用VSCode原生对话框的完整审批工作流\n   - 审批和完成的声音通知\n   - 编辑器中用于审批和评论的上下文菜单操作\n\n   **重要提示：** 对于CLI用户，Web仪表板是必需的。对于VSCode用户，扩展替代了单独Web仪表板的需要，同时直接在您的IDE中提供相同的功能。\n\n## 使用方法\n\n您只需在对话中提及spec-workflow或您为MCP服务器指定的任何名称。AI将自动处理完整的工作流，或者您可以使用下面的一些示例提示：\n\n### 创建规范\n- **\"为用户认证创建规范\"** - 为该功能创建完整的规范工作流\n- **\"创建名为payment-system的规范\"** - 构建完整的需求 → 设计 → 任务\n- **\"为@prd构建规范\"** - 获取您现有的PRD并从中创建完整的规范工作流\n- **\"为购物车创建规范 - 包括添加到购物车、数量更新和结账集成\"** - 详细功能规范\n\n### 获取信息\n- **\"列出我的规范\"** - 显示所有规范及其当前状态\n- **\"显示user-auth的进度\"** - 显示详细的进度信息\n\n### 实施\n- **\"执行user-auth规范中的任务1.2\"** - 运行您规范中的特定任务\n- **\"从仪表板复制提示\"** - 使用仪表板任务列表中的\"复制提示\"按钮\n\n代理自动处理审批工作流、任务管理，并指导您完成每个阶段。\n\n## MCP客户端设置\n\n<details>\n<summary><strong>Augment Code</strong></summary>\n\n在您的Augment设置中配置：\n```json\n{\n  \"mcpServers\": {\n    \"spec-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Claude Code CLI</strong></summary>\n\n添加到您的MCP配置中：\n```bash\nclaude mcp add spec-workflow npx @al76/tools-and-spec-workflow-mcp@latest -- /path/to/your/project\n```\n\n**重要提示：**\n- `-y`标志绕过npm提示以实现更流畅的安装\n- `--`分隔符确保路径传递给spec-workflow脚本，而不是npx\n- 将`/path/to/your/project`替换为您实际的项目目录路径\n\n**Windows替代方案（如果上述方法不起作用）：**\n```bash\nclaude mcp add spec-workflow cmd.exe /c \"npx @al76/tools-and-spec-workflow-mcp@latest /path/to/your/project\"\n```\n</details>\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\n添加到`claude_desktop_config.json`：\n```json\n{\n  \"mcpServers\": {\n    \"spec-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"]\n    }\n  }\n}\n```\n\n或使用自动启动的仪表板：\n```json\n{\n  \"mcpServers\": {\n    \"spec-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\", \"--AutoStartDashboard\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Cline/Claude Dev</strong></summary>\n\n添加到您的MCP服务器配置中：\n```json\n{\n  \"mcpServers\": {\n    \"spec-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Continue IDE扩展</strong></summary>\n\n添加到您的Continue配置中：\n```json\n{\n  \"mcpServers\": {\n    \"spec-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Cursor IDE</strong></summary>\n\n添加到您的Cursor设置中（`settings.json`）：\n```json\n{\n  \"mcpServers\": {\n    \"spec-workflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>OpenCode</strong></summary>\n\n添加到您的`opencode.json`配置文件中（全局在`~/.config/opencode/opencode.json`或项目特定）：\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"spec-workflow\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@al76/tools-and-spec-workflow-mcp@latest\", \"/path/to/your/project\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n</details>\n\n> **注意：** 将`/path/to/your/project`替换为您希望规范工作流运行的项目目录的实际路径。\n\n## 可用工具\n\n### 工作流指南\n- `spec-workflow-guide` - 规范驱动工作流过程的完整指南\n- `steering-guide` - 创建项目指导文档的指南\n\n### 规范管理\n- `create-spec-doc` - 创建/更新规范文档（需求、设计、任务）\n- `spec-list` - 列出所有规范及其状态信息\n- `spec-status` - 获取特定规范的详细状态\n- `manage-tasks` - 规范实施的综合任务管理\n\n### 上下文和模板\n- `get-template-context` - 获取所有文档类型的markdown模板\n- `get-steering-context` - 获取项目指导上下文和指导\n- `get-spec-context` - 获取特定规范的上下文\n\n### 指导文档\n- `create-steering-doc` - 创建项目指导文档（产品、技术、结构）\n\n### 审批系统\n- `request-approval` - 请求用户对文档的审批\n- `get-approval-status` - 检查审批状态\n- `delete-approval` - 清理已完成的审批\n\n## 用户界面\n\n### Web仪表板\n\nWeb仪表板是CLI用户的独立服务。每个项目都有自己的专用仪表板，运行在临时端口上。仪表板提供：\n\n- **实时项目概览** - 规范和进度的实时更新\n- **文档查看器** - 阅读需求、设计和任务文档\n- **任务进度跟踪** - 可视化进度条和任务状态\n- **指导文档** - 快速访问项目指导\n- **深色模式** - 自动启用以获得更好的可读性\n\n#### 仪表板功能\n- **规范卡片** - 每个规范的概览，带有状态指示器\n- **文档导航** - 在需求、设计和任务之间切换\n- **任务管理** - 查看任务进度并复制实施提示\n- **实时更新** - WebSocket连接用于实时项目状态\n\n### VSCode扩展\n\nVSCode扩展直接在您的IDE内提供所有仪表板功能：\n\n- **侧边栏集成** - 从活动栏访问所有功能\n- **归档管理** - 在活跃和已归档的规范之间切换\n- **原生对话框** - 所有操作的VSCode确认对话框\n- **编辑器集成** - 审批和评论的上下文菜单操作\n- **声音通知** - 可配置的音频提醒\n- **无外部依赖** - 完全在VSCode内工作\n\n#### VSCode用户的扩展优势\n- **单一环境** - 无需在浏览器和IDE之间切换\n- **原生体验** - 使用VSCode的原生UI组件\n- **更好的集成** - 上下文菜单操作和编辑器集成\n- **简化设置** - 无需单独的仪表板服务\n\n## 工作流过程\n\n### 1. 项目设置（推荐）\n```\nsteering-guide → create-steering-doc (product, tech, structure)\n```\n创建指导项目开发的基础文档。\n\n### 2. 功能开发\n```\nspec-workflow-guide → create-spec-doc → [review] → implementation\n```\n顺序过程：需求 → 设计 → 任务 → 实施\n\n### 3. 实施支持\n- 使用`get-spec-context`获取详细的实施上下文\n- 使用`manage-tasks`跟踪任务完成情况\n- 通过Web仪表板监控进度\n\n## 文件结构\n\n```\nyour-project/\n  .spec-workflow/\n    steering/\n      product.md        # 产品愿景和目标\n      tech.md          # 技术决策\n      structure.md     # 项目结构指导\n    specs/\n      {spec-name}/\n        requirements.md # 需要构建什么\n        design.md      # 如何构建\n        tasks.md       # 实施分解\n    approval/\n      {spec-name}/\n        {document-id}.json # 审批状态跟踪\n```\n\n## 开发\n\n```bash\n# 安装依赖\nnpm install\n\n# 构建项目\nnpm run build\n\n# 开发模式运行（自动重载）\nnpm run dev\n\n# 启动生产服务器\nnpm start\n\n# 清理构建产物\nnpm run clean\n```\n\n## 故障排除\n\n### 常见问题\n\n1. **Claude MCP配置与项目路径不工作**\n   - 确保您使用正确的语法：`claude mcp add spec-workflow npx -y @al76/tools-and-spec-workflow-mcp@latest -- /path/to/your/project`\n   - `--`分隔符对于将路径传递给脚本而不是npx至关重要\n   - 验证路径存在且可访问\n   - 对于包含空格的路径，确保在您的shell中正确引用\n   - 检查您的`claude.json`中生成的配置，确保路径出现在`args`数组中\n\n2. **仪表板无法启动**\n   - 确保在启动仪表板服务时使用`--dashboard`标志\n   - 仪表板必须与MCP服务器分开启动\n   - 检查控制台输出中的仪表板URL和任何错误消息\n   - 如果使用`--port`，确保端口号有效（1024-65535）且未被其他应用程序使用\n\n3. **审批不工作**\n   - 验证仪表板与MCP服务器一起运行\n   - 仪表板是文档审批和任务跟踪所必需的\n   - 检查两个服务都指向相同的项目目录\n\n4. **MCP服务器无法连接**\n   - 验证配置中的文件路径是否正确\n   - 确保项目已使用`npm run build`构建\n   - 检查Node.js是否在您的系统PATH中可用\n\n5. **端口冲突**\n   - 如果收到\"端口已被使用\"错误，请尝试使用`--port <different-number>`使用不同端口\n   - 使用`netstat -an | find \":3000\"`（Windows）或`lsof -i :3000`（macOS/Linux）检查端口使用情况\n   - 省略`--port`参数以自动使用可用的临时端口\n\n6. **仪表板不更新**\n   - 仪表板使用WebSocket进行实时更新\n   - 如果连接丢失，请刷新浏览器\n   - 检查控制台是否有JavaScript错误\n\n### 获取帮助\n\n- 查看[问题](../../issues)页面了解已知问题\n- 使用提供的模板创建新问题\n- 使用工具内的工作流指南获取分步说明\n\n## 许可证\n\nGPL-3.0\n","readmeFilename":"README.md"}