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

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

🚀 快速开始

1. 安装和配置

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

# 安装依赖
npm install

# 初始化环境配置
npm run start

2. 环境变量配置

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

首次使用配置步骤：

1. 运行初始化脚本：

   npm run start

   脚本会自动创建 .env.example 文件并指导你配置。

2. 创建环境变量文件：

   cp .env.example .env

3. 配置API密钥（至少配置一个）：

   # 编辑 .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. 验证配置：

   npm run start

支持的AI服务：

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

3. 开发模式

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

# 运行测试
npm run test

# MCP工具测试
npm run test:mcp

4. 构建和发布

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

# 快速构建
npm run build:quick

📦 MCP客户端集成

开发环境集成

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

生产环境集成

{
  "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密钥才能正常使用。

🛠️ 可用命令

开发命令

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

测试命令

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           # 运行所有测试

实用命令

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