intention-coding

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

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

🚀 快速开始

1. 安装和配置

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

# 安装依赖
npm install

# 初始化环境配置
npm run start

2. 环境变量配置

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

首次使用配置步骤：

• 运行初始化脚本：

  npm run start
  

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

• 创建环境变量文件：

  cp .env.example .env
  

• 配置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
  

• 验证配置：

  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集成