DBJavaGenix

智能Java代码生成器 - 基于MCP服务架构的数据库驱动代码生成工具

测试示例

核心特性

我们提供的服务

• 多数据库支持: MySQL、PostgreSQL、SQLite分析
• 完整分层代码: Entity、DAO、Service、Controller、Mapper
• 三套模板架构: Default、MybatisPlus、MybatisPlus-Mixed
• 智能包结构: 基于表前缀自动优化包组织
• 依赖管理: 自动检查、修复和优化Maven依赖
• 项目验证: SpringBoot项目结构检测和修复
• 现代注解: Lombok、Swagger、MapStruct集成

暂未提供的服务

• AI语义理解（计划中）
• 业务语义推断（计划中）
• 多语言支持（仅Java）

架构设计

用户连接数据库 → 表结构分析 → 模板渲染 → 完整Java项目代码

核心组件

• MCP服务器: 提供数据库分析和代码生成服务
• 数据库分析器: 表结构、关系和元数据分析
• 代码生成器: 基于Mustache模板的Java代码生成
• 依赖管理器: 智能依赖检查、修复和迁移
• 项目验证器: SpringBoot项目结构检测

快速开始

环境要求

• Node.js 16+
• Claude Desktop 或支持MCP的LLM客户端
• Java开发环境（用于生成的代码）

安装配置（推荐方式）

1. 通过npm安装

npm install -g dbjavagenix-mcp-server

1. 配置MCP客户端 在Claude Desktop或您的MCP客户端中添加以下配置：

{
  "mcpServers": {
    "dbjavagenix": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dbjavagenix-mcp-server"]
    }
  }
}

1. 启动服务

npx dbjavagenix-mcp-server

开发者安装方式

1. 克隆项目

git clone https://github.com/ZhaoXingPeng/DBJavaGenix.git
cd DBJavaGenix

1. 安装Python依赖

# 使用uv（推荐）
uv sync

# 或使用pip
pip install -r requirements.txt

1. 启动开发环境

# Windows
start-mcp.bat

# Linux/Mac
chmod +x start-mcp.sh && ./start-mcp.sh

使用方式

DBJavaGenix通过MCP工具与LLM交互，您需要向LLM提供以下信息：

📝 示例Prompt模板

请帮我生成Java代码：

**数据库信息：**
- 类型：MySQL
- 主机：localhost:3306
- 数据库：test_db
- 用户名：root
- 密码：password

**生成选项：**
- 表名：user
- 模板分类：MybatisPlus-Mixed
- 包名：com.example.project
- 作者：YourName
- 包含：Swagger + Lombok + MapStruct

请先连接数据库，分析表结构，然后生成完整的Java代码。

可用的MCP工具

模板分类说明

支持的数据库

• MySQL 5.7+ / 8.0+
• SQLite 3.x
• PostgreSQL (开发中)
• Oracle (计划中)

项目结构

DBJavaGenix/
├── src/dbjavagenix/           # 主要源码
│   ├── core/                  # 核心功能模块
│   ├── database/              # 数据库分析工具
│   ├── ai/                    # AI服务集成
│   ├── generator/             # 代码生成器
│   ├── templates/             # Java代码模板
│   ├── utils/                 # 工具类
│   └── server/                # MCP服务器
└──  config/                    # 配置文件

开发指南

开发环境搭建

# 克隆项目
git clone https://github.com/ZhaoXingPeng/DBJavaGenix.git
cd DBJavaGenix

# 创建虚拟环境
uv venv
source .venv/bin/activate  # Linux/Mac
# 或 .venv\Scripts\activate  # Windows

# 安装开发依赖
uv sync --extra dev

分支策略

• main: 稳定版本，用于发布
• develop: 开发分支，功能集成
• feature/*: 功能分支，从develop分出
• hotfix/*: 紧急修复，从main分出

开发流程

1. 创建功能分支

git checkout develop
git pull origin develop
git checkout -b feature/your-feature-name

1. 开发和测试

# 运行测试
python -m pytest tests/ -v

# 代码格式化
black src/ tests/
flake8 src/ tests/

# 类型检查
mypy src/

1. 提交代码

git add .
git commit -m "feat: add your feature description"
git push origin feature/your-feature-name

代码规范

• 提交信息: 遵循 Conventional Commits
• 代码风格: Black + Flake8
• 类型注解: 使用 mypy 进行类型检查
• 文档: 为新功能添加相应文档

调试技巧

# 启动MCP服务器调试模式
python -m dbjavagenix.server.mcp_server --debug

# 查看详细日志
export PYTHONPATH=src
python -m dbjavagenix.cli --verbose

贡献指南

欢迎贡献代码！请遵循以下流程：

1. Fork 项目到您的GitHub账户
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

致谢

• EasyCode - 模板设计灵感来源

联系方式

• 作者：ZXP
• 邮箱：2638265504@qq.com
• 项目地址：https://github.com/ZhaoXingPeng/DBJavaGenix
• 问题反馈：https://github.com/ZhaoXingPeng/DBJavaGenix/issues