admin-gen-mcp 0.1.0__tar.gz

admin_gen_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: admin-gen-mcp
+Version: 0.1.0
+Summary: Vue 3 + Element Plus + Spring Boot 全栈代码生成器 MCP Server
+Project-URL: Homepage, https://github.com/yourname/admin-gen-mcp
+Project-URL: Repository, https://github.com/yourname/admin-gen-mcp
+Author-email: Your Name <your@email.com>
+License-Expression: MIT
+Keywords: admin,code-generator,element-plus,mcp,spring-boot,vue
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: openai>=1.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Admin Gen MCP
+
+Vue 3 + Element Plus 前端 & Spring Boot + MyBatis-Plus 后端 全栈代码生成器，基于 MCP 协议。
+
+## 功能
+
+- **前端生成**：api.ts, options.ts, index.vue, form.vue
+- **后端生成**：Entity, Controller, Service, ServiceImpl, Mapper, Mapper.xml
+- **全栈生成**：一份 JSON 配置同时生成前端 + 后端（自动类型映射）
+- 支持主表 + 多子表
+- 支持字典配置
+- 调用阿里云 qwen3-max 模型生成代码
+
+## 安装
+
+```bash
+pip install admin-gen-mcp
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/yourname/admin-gen-mcp.git
+cd admin-gen-mcp
+pip install -e .
+```
+
+## 环境变量
+
+使用前必须设置阿里云 DashScope API Key：
+
+```bash
+export DASHSCOPE_API_KEY="your-api-key"
+```
+
+Windows:
+```cmd
+set DASHSCOPE_API_KEY=your-api-key
+```
+
+## 使用方式
+
+### 1. Claude Code MCP
+
+```bash
+claude mcp add-json admin-gen '{"type":"stdio","command":"admin-gen-mcp","env":{"DASHSCOPE_API_KEY":"your-api-key"}}'
+```
+
+或使用 uvx（无需 pip install）：
+
+```bash
+claude mcp add-json admin-gen '{"type":"stdio","command":"uvx","args":["admin-gen-mcp"],"env":{"DASHSCOPE_API_KEY":"your-api-key"}}'
+```
+
+### 2. Cursor / VS Code MCP
+
+在 `.cursor/mcp.json` 或 `.vscode/settings.json` 中配置：
+
+```json
+{
+  "mcpServers": {
+    "admin-gen": {
+      "command": "admin-gen-mcp",
+      "env": {
+        "DASHSCOPE_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### 3. 命令行工具
+
+```bash
+# 从 JSON 配置文件生成前端代码
+admin-gen --config fields/example.json
+
+# 交互模式
+admin-gen -i
+```
+
+### 4. Python API
+
+```python
+from admin_gen_mcp.generator import CodeGenerator
+
+gen = CodeGenerator(api_key="your-api-key")
+config = gen.load_config("fields/example.json")
+
+# 全栈生成
+results = gen.generate_fullstack(config)
+print(results["frontend"])  # 前端 4 个文件
+print(results["backend"])   # 后端 6~9 个文件
+```
+
+## MCP 工具列表
+
+| 工具 | 说明 |
+|------|------|
+| `generate_admin_page` | 前端代码生成（直接传字段参数） |
+| `generate_from_config` | 前端代码生成（JSON 配置文件路径） |
+| `generate_backend_code` | 后端代码生成（直接传字段参数） |
+| `generate_fullstack` | 前后端一体生成（JSON 配置文件路径） |
+
+## 配置文件格式
+
+```json
+{
+  "功能名称": "员工培训申请",
+  "模块路径": "hr/trainApplication",
+  "权限前缀": "hr_trainapplication",
+  "输出目录": "src/views",
+
+  "主表字段": [
+    {
+      "label": "培训主题",
+      "key": "trainTitle",
+      "type": "input",
+      "required": true,
+      "show": true,
+      "alwaysHide": false,
+      "smart": true,
+      "width": "200"
+    }
+  ],
+
+  "子表配置": [
+    {
+      "名称": "参训人员明细",
+      "标识": "detail",
+      "实体名称": "TrainApplicationDetail",
+      "字段列表": [...]
+    }
+  ],
+
+  "字典配置": [
+    { "key": "trainType", "dict": "hr_train_type", "import": "/@/enums/dict" }
+  ]
+}
+```
+
+## 字段类型映射
+
+| 前端 type | 前端组件 | Java 类型 |
+|-----------|---------|-----------|
+| input | el-input | String |
+| textarea | el-input[textarea] | String |
+| select | el-select | String |
+| date | el-date-picker | LocalDate |
+| datetime | el-date-picker | LocalDateTime |
+| number | microme-operator | BigDecimal |
+| upload | upload-file | String |
+
+## License
+
+MIT

admin_gen_mcp-0.1.0/README.md

@@ -0,0 +1,156 @@
+# Admin Gen MCP
+
+Vue 3 + Element Plus 前端 & Spring Boot + MyBatis-Plus 后端 全栈代码生成器，基于 MCP 协议。
+
+## 功能
+
+- **前端生成**：api.ts, options.ts, index.vue, form.vue
+- **后端生成**：Entity, Controller, Service, ServiceImpl, Mapper, Mapper.xml
+- **全栈生成**：一份 JSON 配置同时生成前端 + 后端（自动类型映射）
+- 支持主表 + 多子表
+- 支持字典配置
+- 调用阿里云 qwen3-max 模型生成代码
+
+## 安装
+
+```bash
+pip install admin-gen-mcp
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/yourname/admin-gen-mcp.git
+cd admin-gen-mcp
+pip install -e .
+```
+
+## 环境变量
+
+使用前必须设置阿里云 DashScope API Key：
+
+```bash
+export DASHSCOPE_API_KEY="your-api-key"
+```
+
+Windows:
+```cmd
+set DASHSCOPE_API_KEY=your-api-key
+```
+
+## 使用方式
+
+### 1. Claude Code MCP
+
+```bash
+claude mcp add-json admin-gen '{"type":"stdio","command":"admin-gen-mcp","env":{"DASHSCOPE_API_KEY":"your-api-key"}}'
+```
+
+或使用 uvx（无需 pip install）：
+
+```bash
+claude mcp add-json admin-gen '{"type":"stdio","command":"uvx","args":["admin-gen-mcp"],"env":{"DASHSCOPE_API_KEY":"your-api-key"}}'
+```
+
+### 2. Cursor / VS Code MCP
+
+在 `.cursor/mcp.json` 或 `.vscode/settings.json` 中配置：
+
+```json
+{
+  "mcpServers": {
+    "admin-gen": {
+      "command": "admin-gen-mcp",
+      "env": {
+        "DASHSCOPE_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### 3. 命令行工具
+
+```bash
+# 从 JSON 配置文件生成前端代码
+admin-gen --config fields/example.json
+
+# 交互模式
+admin-gen -i
+```
+
+### 4. Python API
+
+```python
+from admin_gen_mcp.generator import CodeGenerator
+
+gen = CodeGenerator(api_key="your-api-key")
+config = gen.load_config("fields/example.json")
+
+# 全栈生成
+results = gen.generate_fullstack(config)
+print(results["frontend"])  # 前端 4 个文件
+print(results["backend"])   # 后端 6~9 个文件
+```
+
+## MCP 工具列表
+
+| 工具 | 说明 |
+|------|------|
+| `generate_admin_page` | 前端代码生成（直接传字段参数） |
+| `generate_from_config` | 前端代码生成（JSON 配置文件路径） |
+| `generate_backend_code` | 后端代码生成（直接传字段参数） |
+| `generate_fullstack` | 前后端一体生成（JSON 配置文件路径） |
+
+## 配置文件格式
+
+```json
+{
+  "功能名称": "员工培训申请",
+  "模块路径": "hr/trainApplication",
+  "权限前缀": "hr_trainapplication",
+  "输出目录": "src/views",
+
+  "主表字段": [
+    {
+      "label": "培训主题",
+      "key": "trainTitle",
+      "type": "input",
+      "required": true,
+      "show": true,
+      "alwaysHide": false,
+      "smart": true,
+      "width": "200"
+    }
+  ],
+
+  "子表配置": [
+    {
+      "名称": "参训人员明细",
+      "标识": "detail",
+      "实体名称": "TrainApplicationDetail",
+      "字段列表": [...]
+    }
+  ],
+
+  "字典配置": [
+    { "key": "trainType", "dict": "hr_train_type", "import": "/@/enums/dict" }
+  ]
+}
+```
+
+## 字段类型映射
+
+| 前端 type | 前端组件 | Java 类型 |
+|-----------|---------|-----------|
+| input | el-input | String |
+| textarea | el-input[textarea] | String |
+| select | el-select | String |
+| date | el-date-picker | LocalDate |
+| datetime | el-date-picker | LocalDateTime |
+| number | microme-operator | BigDecimal |
+| upload | upload-file | String |
+
+## License
+
+MIT

admin_gen_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "admin-gen-mcp"
+version = "0.1.0"
+description = "Vue 3 + Element Plus + Spring Boot 全栈代码生成器 MCP Server"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Your Name", email = "your@email.com" }
+]
+keywords = ["mcp", "vue", "element-plus", "spring-boot", "code-generator", "admin"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "openai>=1.0.0",
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+admin-gen = "admin_gen_mcp.generator:main"
+admin-gen-mcp = "admin_gen_mcp._cli:run_server"
+
+[project.urls]
+Homepage = "https://github.com/yourname/admin-gen-mcp"
+Repository = "https://github.com/yourname/admin-gen-mcp"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/admin_gen_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/admin_gen_mcp",
+    "README.md",
+    "pyproject.toml",
+]

admin_gen_mcp-0.1.0/src/admin_gen_mcp/__init__.py

@@ -0,0 +1,6 @@
+"""
+Admin Page Generator MCP Server
+Vue 3 + Element Plus 后台管理页面代码生成器
+"""
+
+__version__ = "0.1.0"

admin_gen_mcp-0.1.0/src/admin_gen_mcp/__main__.py

@@ -0,0 +1,4 @@
+"""python -m admin_gen_mcp  →  启动 MCP Server"""
+from admin_gen_mcp._cli import run_server
+
+run_server()

admin_gen_mcp-0.1.0/src/admin_gen_mcp/_cli.py

@@ -0,0 +1,9 @@
+"""CLI entry points (sync wrappers for async functions)."""
+import asyncio
+
+from .server import main
+
+
+def run_server():
+    """Sync entry point for `admin-gen-mcp` command."""
+    asyncio.run(main())

admin_gen_mcp-0.1.0/src/admin_gen_mcp/commands/admin-gen.md

@@ -0,0 +1,127 @@
+# 后台管理页面生成器
+
+你是一个专业的 Vue 3 + Element Plus 后台管理系统页面生成专家。根据用户提供的需求信息，参考模板文件生成高质量的管理页面代码。
+
+## 技术栈
+
+- Vue 3 (Composition API + `<script setup>`)
+- Element Plus
+- TypeScript
+- vue-i18n（国际化）
+- moment（日期处理）
+
+## 参考模板
+
+生成代码前，必须先读取以下模板文件作为代码风格和结构的参考：
+
+- `templates/api.ts` - API 接口模板
+- `templates/options.ts` - 字段配置模板（包含主表 dataMasterEntity 和子表 dataDetailEntity）
+- `templates/index.vue` - 列表页模板
+- `templates/form.vue` - 表单页模板（包含子表的表格编辑）
+
+## 生成文件
+
+根据用户提供的模块路径，生成以下 4 个文件：
+
+```
+src/views/{module}/{feature}/
+├── api.ts          # API 接口定义
+├── options.ts      # 字段配置（主表 + 子表）
+├── index.vue       # 列表页
+└── form.vue        # 表单页（包含子表编辑）
+```
+
+## 用户输入
+
+用户需要提供：
+1. **功能名称**：如"项目资产抵入"
+2. **模块路径**：如 `financialcapital/DebtProjectAssetsOffset`
+3. **主表字段**：包含字段标识、名称、类型、是否必填、是否显示等信息
+4. **子表配置**（可选）：子表名称、标识、字段列表
+5. **字典配置**：需要使用的字典及其来源
+
+## 执行步骤
+
+1. 读取 `templates/` 目录下的所有模板文件
+2. 根据用户提供的字段信息，参照模板生成对应代码
+3. 如果有子表配置，在 options.ts 中生成 dataDetailEntity，在 form.vue 中生成子表编辑区域
+4. 保存生成的代码到指定目录
+
+## 代码规范
+
+1. **国际化**：文本使用 `t('column.{processDefKey}.master.{fieldName}')` 格式，子表使用 `t('column.{processDefKey}.detail.{fieldName}')`
+2. **权限控制**：按钮使用 `v-auth="'{module}_{feature}_{action}'"` 指令
+3. **异步组件**：使用 `defineAsyncComponent` 加载子组件
+4. **注释**：关键逻辑添加中文注释
+
+## 字段类型映射
+
+| 字段类型 | Element Plus 组件 |
+|---------|------------------|
+| input | el-input |
+| textarea | el-input[type=textarea] |
+| select | el-select |
+| radio | el-radio-group |
+| date | el-date-picker[type=date] |
+| datetime | el-date-picker[type=datetime] |
+| number | microme-operator |
+| upload | upload-file |
+
+## 子表生成规则
+
+当配置中包含"子表配置"时，需要为每个子表生成对应的代码：
+
+### 1. options.ts 中生成
+
+```typescript
+// 主表配置
+export const dataMasterEntity = { ... }
+
+// 子表1配置
+export const dataDetailEntity = { ... }
+
+// 子表2配置（如果有）
+export const dataDetailProjectEntity = { ... }
+```
+
+### 2. form.vue 中生成
+
+每个子表需要：
+- 独立的折叠面板区域 `<el-collapse-item>`
+- 新增/删除按钮
+- el-table 可编辑表格
+- 子表验证规则，如 `dataDetailRules`、`dataDetailProjectRules`
+- 子表相关变量：
+  - `detailTable`、`detailProjectTable` - 表格引用
+  - `detailSelectRows`、`detailProjectSelectRows` - 选中行
+  - `detailColumns`、`detailProjectColumns` - 列配置
+- 子表相关方法：
+  - `addDetailClick()`、`addDetailProjectClick()` - 新增行
+  - `deleteDetailClick()`、`deleteDetailProjectClick()` - 删除行
+  - `detailSelectChangeHandle()`、`detailProjectSelectChangeHandle()` - 选择变化
+
+### 3. dataForm 中包含子表数组
+
+```typescript
+const dataForm = reactive({
+  // 主表字段...
+  detail: [],           // 子表1数据
+  detailProject: [],    // 子表2数据（如果有）
+})
+```
+
+### 4. 子表按钮禁用逻辑
+
+```typescript
+// 新增按钮禁用：查看模式或表单禁用时
+const isAddDetailDisabled = computed(() => FormDisabled.value)
+
+// 删除按钮禁用：没有选中行或表单禁用时
+const isDelDetailDisabled = computed(() => 
+  detailSelectRows.value.length === 0 || FormDisabled.value
+)
+```
+
+## 用户输入
+
+$ARGUMENTS