design-mcp

# AI Agent设计工具 - MCP 服务器 ## 📋 项目概述 这是一个基于 FastMCP 的 AI Agent设计工具，实现了 SSE 流式响应处理，集成了 RAG 增强检索召回设计文档模版功能。结合 Agent 可实现沉浸式设计，支持多次交互后自动化输出 JD JoySpace 设计文档。 ### 核心特性 - 📄 **智能文档生成**：自动创建 JoySpace 设计文档，指定空间和文件路径 - 🎯 **RAG 增强检索**：支持设计文档模版智能化召回，不同场景匹配不同模版 - 🚀 **SSE 流式响应处理**：支持实时接收和处理流式数据 - 🔧 **双模式运行**：支持服务交互式模式 和 Agent MCP 服务器挂载模式 ## 🚀 快速开始 ### 环境要求 - Python 3.10 或更高版本 ### 安装工具 ```bash pip3 install --upgrade design-mcp --break-system-packages ``` ## 🔧 MCP 客户端本地配置 ### JoyCode/Claude Desktop 配置 ```json { "mcpServers": { "design": { "command": "design", "args": [ "--mcp" ], "env": { "erp": "zhouyiru", "joySpaceId": "CXhEKMPNaDMigxHyGSVp", "joyFolderId": "rMnu22BMXrCep8HwfZCt", "templateName": "6.0研发设计文档模版" } } } } ``` ### 搭配设计Agent指令 - 可设定Agent智能体 ```bash 你是一名资深系统架构师，负责将业务需求任务转化为技术设计文档，生成流程图一定要用markdown格式的或者slate json来画图，千万不要用mermaid格式。 1、首先要通过design mcp传入“【设计文档模版】”，获取研发设计文档模版作为你设计内容的参照，读取本地代码库源码分析设计方案。 2、你的设计方案过程中需要与我交流沟通，有任何疑问和思考需要让我决策。 3、最终方案完备后让我选择输入“设计完毕”指令，（仅此一次）使用design mcp工具传入最终设计文档内容，提示词是：标题：你输出的设计文档标题，内容：你输出的设计文档内容 。 输入：接收需求描述和故事点（如PRD文档、用户故事、原型图）。 输出：生成符合JoySpace标准的Markdown格式设计文档。 风格：语言简洁、逻辑严谨，兼顾技术深度与可读性，避免冗余。 ``` ## 🛠️ 可用工具 ### `ai_design` AI Agent设计工具的核心功能 **参数说明**： - `erp` (必须配置): 用户ERP，可通过环境变量 `erp` 设置 - `joySpaceId` (必须配置): JoySpace 空间ID - `joyFolderId` (必须配置): JoySpace 文件夹ID - `templateName`（可选）：参照的设计文档模版名称，智能意图场景匹配，如：小微设计、项目概要设计等不同模版（联系维护者进行知识库投喂更多个性化模版召回） **项目状态**: ✅ 正常运行 **最后更新**: 2025-08-19 **维护者**: zhouyiru