AI Partner URS MCP Server

为 Cursor 终端大模型提供用户需求规格说明书(URS)相关提示词的 MCP Server。

🎯 功能概述

AI Partner URS MCP Server 是一个专门为 Cursor 终端大模型设计的 MCP (Model Context Protocol) 服务器，提供完整的用户需求规格说明书编写支持。

核心功能

• URS文档提示词获取：获取各种URS文档编写的专业提示词
• URS项目初始化：初始化URS文档项目结构
• URS文档编写指导：提供下一步编写建议和指导
• URS文档生成：基于用户需求自动生成URS文档
• URS文档质量检查：对URS文档进行质量评估
• URS文档总结报告：生成URS文档完成度分析报告
• URS编写帮助指南：提供详细的编写指导和最佳实践

🛠️ 可用工具

1. urs_document_prompt

获取用户需求规格说明书(URS)编写的提示词。

参数说明：

• filePath (必需)：完整的文件路径，必须包含目录结构
• silent (可选)：是否静默执行，默认为 true

常用路径示例：

• .cursor/rules/urs/design-methodology/urs-function-requirements-design-thinking.mdc - 功能需求设计思考方法论
• .cursor/rules/urs/templates/docs/template-urs-specific-function-requirement.mdc - 具体功能需求模板
• .cursor/rules/urs/design-methodology/urs-user-requirements-design-thinking.mdc - 用户需求设计思考
• .cursor/rules/urs/design-methodology/urs-overview-design-thinking.mdc - 项目概述设计思考
• .cursor/rules/urs/design-methodology/urs-non-functional-requirements-design-thinking.mdc - 非功能需求设计思考

2. urs_initialization

URS项目初始化工具，用于创建必要的目录结构和初始文档。

参数说明：

• projectName (必需)：项目名称
• projectDescription (必需)：项目描述
• force (可选)：是否强制重新初始化，默认为 false

3. urs_next_step

URS文档编写下一步指导工具，基于当前状态提供编写建议。

参数说明：

• currentContent (必需)：当前URS文档内容
• focusArea (可选)：重点关注区域，默认为 "all"

4. urs_generate_spec_doc

URS文档生成工具，基于用户需求自动生成URS文档。

参数说明：

• userRequirements (必需)：用户需求描述
• documentType (可选)：文档类型，可选 "full" 或 "section"，默认为 "full"
• targetSection (可选)：目标章节，当documentType为"section"时指定

5. urs_quality_check

URS文档质量检查工具，对URS文档进行全面质量检查。

参数说明：

• documentContent (必需)：URS文档内容
• checkType (可选)：检查类型，可选 "comprehensive"、"structure" 或 "content"，默认为 "comprehensive"

6. urs_summary_report

URS文档总结报告工具，生成URS文档的完成度分析报告。

参数说明：

• documentContent (必需)：URS文档内容
• reportType (可选)：报告类型，可选 "comprehensive"、"progress" 或 "quality"，默认为 "comprehensive"

7. urs_help_guide

URS文档编写帮助指南工具，提供详细的编写指导和最佳实践。

参数说明：

• topic (可选)：帮助主题，默认为 "general"
• detail (可选)：详细问题描述

📁 目录结构

.cursor/rules/urs/
├── design-methodology/                    # 设计思考方法论
│   ├── urs-overview-design-thinking.mdc
│   ├── urs-user-requirements-design-thinking.mdc
│   ├── urs-function-requirements-design-thinking.mdc
│   └── urs-non-functional-requirements-design-thinking.mdc
├── templates/                             # 文档模板
│   └── docs/
│       ├── template-urs-overview-chapter.mdc
│       ├── template-urs-requirements.mdc
│       ├── template-urs-function-design.mdc
│       ├── template-urs-constraint-design.mdc
│       ├── template-urs-specific-function-requirement.mdc
│       └── template-urs-user-scenario.mdc
├── urs-design-methodology.mdc            # URS设计方法论总纲
├── urs-design-thinking-methods.mdc       # URS设计思考方法
├── urs-help-guide.mdc                    # URS编写帮助指南
├── urs-quality-check-report.mdc          # URS质量检查报告
├── urs-progress-summary-report.mdc       # URS进度总结报告
└── urs-initialization.mdc                # URS项目初始化

🚀 快速开始

1. 安装依赖

cd AI-Partner-MCP-URS
npm install

2. 配置Cursor

在 Cursor 的配置文件中添加 MCP 服务器配置：

{
  "mcpServers": {
    "ai-partner-urs": {
      "command": "node",
      "args": ["/path/to/AI-Partner-MCP-URS/server.js"],
      "env": {}
    }
  }
}

3. 使用示例

获取URS文档提示词

使用 urs_document_prompt 工具获取功能需求设计思考方法论
文件路径：.cursor/rules/urs/design-methodology/urs-function-requirements-design-thinking.mdc

初始化URS项目

使用 urs_initialization 工具初始化URS项目
项目名称：企业管理系统
项目描述：开发一个企业级管理系统，包含用户管理、权限管理、数据管理等功能

生成URS文档

使用 urs_generate_spec_doc 工具生成URS文档
用户需求：开发一个在线教育平台，支持课程管理、学生管理、教师管理等功能
文档类型：full

📋 URS文档结构

标准的用户需求规格说明书包含以下章节：

第1章 项目概述

• 1.1 项目背景
• 1.2 项目目标
• 1.3 项目范围
• 1.4 术语定义
• 1.5 参考文档

第2章 用户需求

• 2.1 用户场景分析
• 2.2 业务需求描述
• 2.3 用户故事地图

第3章 功能需求

• 3.1 功能需求列表
• 3.2.X 具体功能需求
  • 3.2.X.1 用户故事
  • 3.2.X.2 功能需求描述
  • 3.2.X.3 用户操作流程
  • 3.2.X.4 界面交互需求
  • 3.2.X.5 数据需求
  • 3.2.X.6 业务规则
  • 3.2.X.7 验收标准

第4章 非功能需求

• 4.1 性能需求
• 4.2 安全需求
• 4.3 可用性需求
• 4.4 兼容性需求
• 4.5 可维护性需求

🎯 设计方法论

本 MCP Server 基于以下设计方法论：

用户驱动的需求思维

• 用户优先原则：所有URS设计必须基于真实用户场景
• 场景驱动机制：每个需求点都有明确的用户场景依据
• 用户分层管理：明确区分不同用户角色的需求

需求完整性评估驱动的设计策略

• 智能完整性识别：从多个维度评估需求完整性
• 分层设计策略：根据复杂度采用不同的设计策略
• 设计适配原则：需求描述深度与业务复杂度匹配

用户场景为中心的需求设计

• 场景优先：从用户实际使用场景设计需求
• 完整用户旅程：设计完整的用户操作旅程
• 价值创造验证：验证每个需求为用户创造的价值

🔧 开发指南

添加新的设计思考方法

1. 在 .cursor/rules/urs/design-methodology/ 目录下创建新的 .mdc 文件
2. 在 mcp-server.json 中更新工具文件路径配置
3. 在 server.js 中添加相应的工具处理逻辑

添加新的文档模板

1. 在 .cursor/rules/urs/templates/docs/ 目录下创建新的模板文件
2. 确保模板文件遵循标准的 .mdc 格式
3. 更新相关文档说明

自定义配置

可以通过修改 mcp-server.json 文件来自定义配置：

{
  "baseUrl": "http://your-server-url:port",
  "toolFilePaths": {
    "init_prompt": ".cursor/rules/urs/urs-initialization.mdc",
    "next_step_prompt": ".cursor/rules/urs/urs-design-thinking-methods.mdc",
    "generate_spec_doc_command": ".cursor/rules/urs/urs-design-thinking-methods.mdc",
    "quality_check_prompt": ".cursor/rules/urs/urs-quality-check-report.mdc",
    "summary_prompt": ".cursor/rules/urs/urs-progress-summary-report.mdc",
    "help_guide": ".cursor/rules/urs/urs-help-guide.mdc"
  }
}

📄 许可证

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。

📞 支持

如果您在使用过程中遇到问题，请：

1. 查看 Issues 页面
2. 提交新的 Issue 描述您的问题
3. 联系开发团队获取支持

AI Partner Team - 让AI助手更智能，让开发更高效