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开发环境（用于生成的代码）
安装配置（推荐方式）
- 通过npm安装
npm install -g dbjavagenix-mcp-server
- 配置MCP客户端 在Claude Desktop或您的MCP客户端中添加以下配置：
{
"mcpServers": {
"dbjavagenix": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "npx",
"args": ["-y", "dbjavagenix-mcp-server"]
}
}
}
- 启动服务
npx dbjavagenix-mcp-server
开发者安装方式
- 克隆项目
git clone https://github.com/ZhaoXingPeng/DBJavaGenix.git
cd DBJavaGenix
- 安装Python依赖
# 使用uv（推荐）
uv sync
# 或使用pip
pip install -r requirements.txt
- 启动开发环境
# 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工具
| 工具名称 | 功能描述 |
|---|---|
db_connect_test | 测试数据库连接 |
db_query_databases | 列出所有数据库 |
db_query_tables | 列出数据库中的表 |
db_query_table_exists | 检查表是否存在 |
db_query_execute | 执行自定义SQL查询 |
db_table_describe | 获取表结构详细信息 |
db_table_columns | 获取表列信息 |
db_table_primary_keys | 获取主键信息 |
db_table_foreign_keys | 获取外键关系 |
db_table_indexes | 获取索引信息 |
db_codegen_analyze | 分析表结构用于代码生成 |
db_codegen_generate | 生成完整Java代码 |
springboot_validate_project | 验证SpringBoot项目结构 |
springboot_analyze_dependencies | 智能分析项目依赖 |
springboot_read_config | 读取Spring Boot配置（YAML/Properties/Bootstrap），推断基础包名与合并有效配置 |
模板分类说明
| 模板分类 | 特点 | 适用场景 |
|---|---|---|
| Default | 传统MyBatis + XML | 复杂SQL，手写优化 |
| MybatisPlus | 纯注解，无XML | 快速开发，简单CRUD |
| MybatisPlus-Mixed | 注解+XML混合 | 推荐选择，灵活性最佳 |
支持的数据库
- 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分出
开发流程
- 创建功能分支
git checkout develop
git pull origin develop
git checkout -b feature/your-feature-name
- 开发和测试
# 运行测试
python -m pytest tests/ -v
# 代码格式化
black src/ tests/
flake8 src/ tests/
# 类型检查
mypy src/
- 提交代码
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
贡献指南
欢迎贡献代码！请遵循以下流程：
- Fork 项目到您的GitHub账户
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建Pull Request
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
致谢
- EasyCode - 模板设计灵感来源