Metadata-Version: 2.4
Name: ai-develop-assistant
Version: 1.0.0
Summary: 协助AI开发者进行智能化需求完善、模块设计、技术架构设计的MCP工具
Project-URL: Homepage, https://github.com/jiemobasixiangcai/ai-develop-assistant
Project-URL: Repository, https://github.com/jiemobasixiangcai/ai-develop-assistant
Author-email: jiemobasixiangcai <39970068+jiemobasixiangcai@users.noreply.github.com>
License: MIT License
        
        Copyright (c) 2025 jiemobasixiangcai
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Requires-Python: >=3.8
Requires-Dist: fastapi>=0.100.0
Requires-Dist: mcp>=1.9.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: typing-extensions>=4.12.0
Requires-Dist: uvicorn>=0.23.0
Description-Content-Type: text/markdown

# ai-develop-assistant
协助AI开发者进行智能化需求完善、模块设计、技术架构设计的MCP工具
# ✨ 优化功能总览
## 🚀 MCP AI开发助手 - 智能需求分析与架构设计
## ✨ 核心特性
### 🧠 智能分支感知系统
1. 分支识别: 自动识别当前讨论的需求分支（项目目标、功能设计、技术偏好、UI设计）
2. 记忆保持: 防止AI在多轮对话中遗忘未完成的需求维度
3. 渐进式澄清: 确保所有核心需求分支都得到充分讨论
4. 智能提醒: 自动提醒未完成的需求分支，防止遗漏

### 🤖 AI自主设计与控制
1. 用户授权检测: 识别"常规设计"、"标准方案"等用户授权AI自主设计的表达
2. 分支式设计: 仅对当前分支进行自主设计，不会跳跃到其他未讨论的分支
3. 完整性门控: 只有所有核心分支完成后才允许进入架构设计阶段
4. AI自我评估: AI主动评估自己对需求的理解深度，不足时拒绝架构设计

# 🚀 MCP AI开发助手 - 最终配置指南
### 🔧 核心工具 (5个)
1. **requirement_clarifier** - 需求澄清助手
2. **requirement_manager** - 需求文档管理器
3. **architecture_designer** - 架构设计生成器
4. **export_final_document** - 导出完整文档 ⭐ 新增
5. **view_requirements_status** - 查看需求状态 ⭐ 新增

### 💾 持久化存储特性
- ✅ **自动保存**: 每次操作都会自动保存到文件
- ✅ **历史记录**: 完整的操作历史追溯
- ✅ **多格式导出**: JSON + Markdown双格式
- ✅ **自定义目录**: 支持环境变量配置存储位置

## 📁 配置方法

### 方法1: Claude Desktop配置 (推荐)

1. **找到配置文件位置**
   ```
   Windows: %APPDATA%\Claude\claude_desktop_config.json
   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   Linux: ~/.config/claude/claude_desktop_config.json
   ```

2. **添加配置内容**
   ```json
   {
     "mcpServers": {
       "ai-develop-assistant": {
         "command": "python",
         "args": [
           "path\AIDevlopStudy.py"
         ],
         "env": {
           "MCP_STORAGE_DIR": "your save path"
         }
       }
     }
   }
   ```

3. **重启Claude Desktop**

### 方法2: 环境变量配置

创建 `.env` 文件：
```bash
# 自定义存储目录
MCP_STORAGE_DIR=./mcp_data

# 或者设置为其他路径
# MCP_STORAGE_DIR=D:/MyProjects/mcp_storage
```

## 📊 存储结构

配置成功后，会在指定目录生成以下文件：

```
mcp_data/
├── requirements.json      # 实时需求文档
├── history.json          # 操作历史记录
├── final_document_*.json # 导出的完整文档
└── final_document_*.md   # Markdown格式报告
```

## 🎯 使用流程

### 完整的项目分析流程

1. **需求澄清阶段**
   ```
   requirement_clarifier("我要做一个WebAI资源分享网站")
   ↓
   requirement_manager("项目类型：Web应用...", "项目概述")
   ↓
   view_requirements_status() # 查看当前状态
   ```

2. **架构设计阶段**
   ```
   architecture_designer("WebAI资源分享网站架构")
   ↓
   view_requirements_status() # 确认完整性
   ```

3. **文档导出阶段**
   ```
   export_final_document() # 导出完整项目文档
   ```

## 🧪 测试验证

运行测试脚本验证配置：
```bash
# 激活虚拟环境
.venv\Scripts\activate

# 运行测试
python test_optimized_mcp.py
```

预期输出：
```
🧪 测试优化后的MCP AI开发助手...
📁 存储目录: test_mcp_data
✅ 发现 5 个工具
✅ 所有功能测试成功
✅ 生成了 4 个文件
🎉 优化版MCP测试完成!
```

## 💡 使用技巧

### 1. 项目开始前
- 设置好 `MCP_STORAGE_DIR` 环境变量
- 确保目录有写入权限

### 2. 需求分析中
- 定期使用 `view_requirements_status` 查看进度
- 每次澄清后都会自动保存

### 3. 项目完成后
- 使用 `export_final_document` 导出完整文档
- Markdown文件可作为项目README基础

### 4. 多项目管理
- 为不同项目设置不同的存储目录
- 使用项目名称作为目录名

## 🔍 故障排除

### 常见问题

1. **存储目录权限问题**
   ```bash
   # 确保目录可写
   mkdir -p ./mcp_data
   chmod 755 ./mcp_data
   ```

2. **环境变量未生效**
   ```bash
   # 检查环境变量
   echo $MCP_STORAGE_DIR
   
   # 重新设置
   export MCP_STORAGE_DIR="./mcp_data"
   ```

3. **文件编码问题**
   - 所有文件使用UTF-8编码
   - 支持中文内容

## 🎉 优势总结

### 相比原版的改进
- ✅ **数据持久化**: 不再丢失分析结果
- ✅ **历史追溯**: 完整的操作记录
- ✅ **文档导出**: 自动生成项目文档
- ✅ **状态查看**: 实时了解分析进度
- ✅ **配置灵活**: 自定义存储位置

### 实际价值
- 🚀 **提升效率**: 避免重复分析
- 📋 **文档完整**: 自动生成项目文档
- 🔄 **过程可控**: 随时查看分析状态
- 💾 **数据安全**: 本地存储，隐私保护

---

**🎯 现在您的MCP AI开发助手已经完全优化，支持持久化存储和完整的项目文档管理！**

开始使用：
1. 配置Claude Desktop
2. 重启Claude Desktop  
3. 开始您的AI项目分析之旅！

