# 智能软件星工厂 - MCP服务器

提供从需求分析到代码生成的完整开发生命周期管理。

## 🚀 快速开始

### 1. 安装和配置

```bash
# 克隆项目
git clone <repository-url>
cd mcp

# 安装依赖
npm install

# 初始化环境配置
npm run start
```

### 2. 环境变量配置

本项目采用**统一的构建时加密 → 运行时解密**配置方案，无论开发还是生产环境都使用相同的配置管理方式。

#### 首次使用配置步骤：

1. **运行初始化脚本**：
   ```bash
   npm run start
   ```
   脚本会自动创建 `.env.example` 文件并指导你配置。

2. **创建环境变量文件**：
   ```bash
   cp .env.example .env
   ```

3. **配置API密钥**（至少配置一个）：
   ```bash
   # 编辑 .env 文件
   QWEN_API_KEY=your_qwen_api_key_here
   KIMI_API_KEY=your_kimi_api_key_here
   GLM_4V_API_KEY=your_glm_4v_api_key_here
   DEEPSEEK_API_KEY=your_deepseek_api_key_here
   OPENAI_API_KEY=your_openai_api_key_here
   ```

4. **验证配置**：
   ```bash
   npm run start
   ```

#### 支持的AI服务：
- **通义千问 (Qwen)** - 主要用于代码生成和文本处理
- **Kimi (月之暗面)** - 支持长文本和图像分析
- **GLM-4V (智谱清言)** - 视觉AI和代码理解
- **DeepSeek** - 代码生成和推理
- **OpenAI兼容API** - 兼容OpenAI格式的API服务

### 3. 开发模式

```bash
# 开始开发（会自动生成配置）
npm run dev

# 运行测试
npm run test

# MCP工具测试
npm run test:mcp
```

### 4. 构建和发布

```bash
# 构建项目（会自动生成加密配置）
npm run build

# 快速构建
npm run build:quick
```

## 📦 MCP客户端集成

### 开发环境集成
```json
{
  "mcpServers": {
    "智能软件星工厂-本地开发版": {
      "command": "npx",
      "args": [
        "tsx",
        "/Users/bjyf/Desktop/project/LLM/auto-code/mcpProject/mcp/src/index.ts"
      ]
    }
  }
}
```

### 生产环境集成
```json
{
  "mcpServers": {
    "智能软件星工厂": {
      "command": "npx",
      "args": [
        "-y",
        "intention-coding"
      ],
      "env": {
        "MCP_STORAGE_DIR": "mcp输出的内容存放的绝对路径，一般是前后端工程的父级文件夹的绝对路径"
      }
    }
  }
}
```

## 🔒 安全特性

### 统一加密配置方案
- ✅ **构建时加密**：所有敏感配置在构建时自动加密
- ✅ **运行时解密**：运行时安全解密使用，无明文存储
- ✅ **统一管理**：开发和生产环境使用相同的配置管理方式
- ✅ **自动降级**：配置获取失败时自动降级到安全默认值

### 配置管理优势
- 🚀 **开发体验一致**：本地开发和生产部署使用相同的配置方式
- 🛡️ **安全性提升**：敏感信息加密存储，避免明文泄露
- 🔄 **自动化流程**：构建时自动生成配置，无需手动管理
- 📊 **智能检测**：自动检测可用API并优化服务选择

## ⚙️ 配置选项

### 环境变量说明

| 变量名 | 描述 | 默认值 | 必需 |
|--------|------|--------|------|
| `QWEN_API_KEY` | 通义千问API密钥 | - | 可选 |
| `KIMI_API_KEY` | Kimi API密钥 | - | 可选 |
| `GLM_4V_API_KEY` | GLM-4V API密钥 | - | 可选 |
| `DEEPSEEK_API_KEY` | DeepSeek API密钥 | - | 可选 |
| `OPENAI_API_KEY` | OpenAI API密钥 | - | 可选 |
| `NODE_ENV` | 运行环境 | `development` | 否 |
| `LOG_LEVEL` | 日志级别 | `info` | 否 |
| `MCP_STORAGE_DIR` | 存储目录 | 自动检测 | 否 |

**注意**：至少需要配置一个AI服务的API密钥才能正常使用。

## 🛠️ 可用命令

### 开发命令
```bash
npm run start          # 环境配置检查和初始化
npm run dev            # 开发模式（监听文件变化）
npm run dev:setup      # 开发环境设置
npm run build          # 完整构建（包含检查和配置生成）
npm run build:dev      # 快速开发构建
npm run build:quick    # 快速构建（跳过检查）
```

### 测试命令
```bash
npm run test                # 运行单元测试
npm run test:watch          # 监听模式测试
npm run test:mcp           # MCP工具集成测试
npm run test:comprehensive # 全面集成测试
npm run test:local-dev     # 本地开发测试
npm run test:integration   # 集成测试套件
npm run test:all           # 运行所有测试
```

### 实用命令
```bash
npm run generate-config    # 生成安全配置
npm run pre-build-check    # 构建前检查
npm run verify-env         # 验证环境配置
npm run debug:openai       # 调试OpenAI集成
```