refactor: 优化MCP工具描述和代码结构

longzhang83 · claude · longzhang83 · commit 211adfcd69b0 · 2026-02-04T00:05:37.000+08:00
- 简化MCP工具描述，移除冗余说明
- 为字典生成工具添加Name/Description/InputSchema方法
- 优化gva_analyze目录清理逻辑
- 重构gva_execute执行计划处理逻辑
- 更新pathInfo.json添加新页面路径

Co-Authored-By: Claude &lt;noreply@anthropic.com&gt;
diff --git a/server/mcp/api_lister.go b/server/mcp/api_lister.go
@@ -42,16 +42,9 @@ type ApiLister struct{}
 // New 创建API列表工具
 func (a *ApiLister) New() mcp.Tool {
 	return mcp.NewTool("list_all_apis",
-		mcp.WithDescription(`获取系统中所有的API接口，分为两组：
+		mcp.WithDescription(`获取系统所有API接口。返回databaseApis(数据库API)和ginApis(gin路由)两组数据。
 
-**功能说明：**
-- 返回数据库中已注册的API列表
-- 返回gin框架中实际注册的路由API列表
-- 帮助前端判断是使用现有API还是需要创建新的API,如果api在前端未使用且需要前端调用的时候，请到api文件夹下对应模块的js中添加方法并暴露给当前业务调用
-
-**返回数据结构：**
-- databaseApis: 数据库中的API记录（包含ID、描述、分组等完整信息）
-- ginApis: gin路由中的API（仅包含路径和方法），需要AI根据路径自行揣摩路径的业务含义，例如：/api/user/:id 表示根据用户ID获取用户信息`),
+**详细说明**: /gva-helper/lister`),
 		mcp.WithString("_placeholder",
 			mcp.Description("占位符，防止json schema校验失败"),
 		),	
diff --git a/server/mcp/dictionary_generator.go b/server/mcp/dictionary_generator.go
@@ -70,6 +70,93 @@ func (d *DictionaryOptionsGenerator) New() mcp.Tool {
 	)
 }
 
+// Name 返回工具名称
+func (d *DictionaryOptionsGenerator) Name() string {
+	return "generate_dictionary_options"
+}
+
+// Description 返回工具描述
+func (d *DictionaryOptionsGenerator) Description() string {
+	return `字典选项生成工具 - 让AI生成并创建字典选项
+
+此工具允许AI根据字典类型和字段描述生成合适的字典选项，并自动创建字典和字典详情。
+
+参数说明：
+- dictType: 字典类型（必填）
+- fieldDesc: 字段描述（必填）
+- options: AI生成的字典选项数组（必填）
+  - label: 选项标签
+  - value: 选项值
+  - sort: 排序号
+- dictName: 字典名称（可选，默认根据fieldDesc生成）
+- description: 字典描述（可选）
+
+使用场景：
+1. 在创建模块时，如果字段需要字典类型，AI可以根据字段描述智能生成合适的选项
+2. 支持各种业务场景的字典选项生成，如状态、类型、等级等
+3. 自动创建字典和字典详情，无需手动配置
+
+示例调用：
+{
+  "dictType": "user_status",
+  "fieldDesc": "用户状态",
+  "options": [
+    {"label": "正常", "value": "1", "sort": 1},
+    {"label": "禁用", "value": "0", "sort": 2}
+  ],
+  "dictName": "用户状态字典",
+  "description": "用于管理用户账户状态的字典"
+}`
+}
+
+// InputSchema 返回输入参数的JSON Schema
+func (d *DictionaryOptionsGenerator) InputSchema() map[string]interface{} {
+	return map[string]interface{}{
+		"type": "object",
+		"properties": map[string]interface{}{
+			"dictType": map[string]interface{}{
+				"type":        "string",
+				"description": "字典类型，用于标识字典的唯一性",
+			},
+			"fieldDesc": map[string]interface{}{
+				"type":        "string",
+				"description": "字段描述，用于生成字典名称和理解字典用途",
+			},
+			"options": map[string]interface{}{
+				"type":        "array",
+				"description": "AI生成的字典选项数组",
+				"items": map[string]interface{}{
+					"type": "object",
+					"properties": map[string]interface{}{
+						"label": map[string]interface{}{
+							"type":        "string",
+							"description": "选项标签，显示给用户的文本",
+						},
+						"value": map[string]interface{}{
+							"type":        "string",
+							"description": "选项值，存储在数据库中的值",
+						},
+						"sort": map[string]interface{}{
+							"type":        "integer",
+							"description": "排序号，用于控制选项显示顺序",
+						},
+					},
+					"required": []string{"label", "value", "sort"},
+				},
+			},
+			"dictName": map[string]interface{}{
+				"type":        "string",
+				"description": "字典名称，必填，默认根据fieldDesc生成",
+			},
+			"description": map[string]interface{}{
+				"type":        "string",
+				"description": "字典描述，必填",
+			},
+		},
+		"required": []string{"dictType", "fieldDesc", "options"},
+	}
+}
+
 // Handle 处理工具调用
 func (d *DictionaryOptionsGenerator) Handle(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
 	// 解析请求参数
diff --git a/server/mcp/gva_analyze.go b/server/mcp/gva_analyze.go
@@ -349,16 +349,7 @@ func (g *GVAAnalyzer) removeDirectoryIfExists(dirPath string) error {
 		return err // 其他错误
 	}
 
-	// 检查目录中是否包含go文件
-	noGoFiles, err := g.hasGoFilesRecursive(dirPath)
-	if err != nil {
-		return err
-	}
-	// hasGoFilesRecursive 返回 false 表示发现了 go 文件
-	if noGoFiles {
-		return os.RemoveAll(dirPath)
-	}
-	return nil
+	return os.RemoveAll(dirPath)
 }
 
 // cleanupRelatedApiAndMenus 清理相关的API和菜单记录
diff --git a/server/mcp/gva_execute.go b/server/mcp/gva_execute.go
diff --git a/server/mcp/gva_review.go b/server/mcp/gva_review.go
@@ -35,37 +35,9 @@ type ReviewResponse struct {
 // New 创建GVA代码审查工具
 func (g *GVAReviewer) New() mcp.Tool {
 	return mcp.NewTool("gva_review",
-		mcp.WithDescription(`**GVA代码审查工具 - 在gva_execute调用后使用**
-
-**核心功能：**
-- 接收经过requirement_analyze处理的用户需求和gva_execute生成的文件列表
-- 分析生成的代码是否满足用户的原始需求
-- 检查是否涉及到关联、交互等复杂功能
-- 如果代码不满足需求，提供调整建议和新的prompt
-
-**使用场景：**
-- 在gva_execute成功执行后调用
-- 用于验证生成的代码是否完整满足用户需求
-- 检查模块间的关联关系是否正确实现
-- 发现缺失的交互功能或业务逻辑
-
-**工作流程：**
-1. 接收用户原始需求和生成的文件列表
-2. 分析需求中的关键功能点
-3. 检查生成的文件是否覆盖所有功能
-4. 识别缺失的关联关系、交互功能等
-5. 生成调整建议和新的开发prompt
-
-**输出内容：**
-- 审查结果和是否需要调整
-- 详细的缺失功能分析
-- 针对性的代码调整建议
-- 可直接使用的开发prompt
-
-**重要提示：**
-- 本工具专门用于代码质量审查，不执行实际的代码修改
-- 重点关注模块间关联、用户交互、业务流程完整性
-- 提供的调整建议应该具体可执行`),
+		mcp.WithDescription(`代码审查工具，在gva_execute后验证生成代码是否满足需求。检查关联关系、交互功能，提供调整建议。
+
+**详细说明**: /gva-helper/gva-review`),
 		mcp.WithString("userRequirement",
 			mcp.Description("经过requirement_analyze处理后的用户需求描述，包含详细的功能要求和字段信息"),
 			mcp.Required(),
diff --git a/server/mcp/menu_lister.go b/server/mcp/menu_lister.go
@@ -32,20 +32,9 @@ type MenuLister struct{}
 // New 创建菜单列表工具
 func (m *MenuLister) New() mcp.Tool {
 	return mcp.NewTool("list_all_menus",
-		mcp.WithDescription(`获取系统中所有菜单信息，包括菜单树结构、路由信息、组件路径等，用于前端编写vue-router时正确跳转
+		mcp.WithDescription(`获取系统所有菜单信息，包括菜单树结构、路由信息、组件路径，用于前端vue-router跳转。
 
-**功能说明：**
-- 返回完整的菜单树形结构
-- 包含路由配置信息（path、name、component）
-- 包含菜单元数据（title、icon、keepAlive等）
-- 包含菜单参数和按钮配置
-- 支持父子菜单关系展示
-
-**使用场景：**
-- 前端路由配置：获取所有菜单信息用于配置vue-router
-- 菜单权限管理：了解系统中所有可用的菜单项
-- 导航组件开发：构建动态导航菜单
-- 系统架构分析：了解系统的菜单结构和页面组织`),
+**详细说明**: /gva-helper/lister`),
 mcp.WithString("_placeholder",
 			mcp.Description("占位符，防止json schema校验失败"),
 		),	
diff --git a/server/mcp/requirement_analyzer.go b/server/mcp/requirement_analyzer.go
@@ -28,36 +28,11 @@ type RequirementAnalysisResponse struct {
 // New 返回工具注册信息
 func (t *RequirementAnalyzer) New() mcp.Tool {
 	return mcp.NewTool("requirement_analyzer",
-		mcp.WithDescription(`** 智能需求分析与模块设计工具 - 首选入口工具（最高优先级）**
-
-** 重要提示：这是所有MCP工具的首选入口，请优先使用！**
-
-** 核心能力：**
-作为资深系统架构师，智能分析用户需求并自动设计完整的模块架构
-
-** 核心功能：**
-1. **智能需求解构**：深度分析用户需求，识别核心业务实体、业务流程、数据关系
-2. **自动模块设计**：基于需求分析，智能确定需要多少个模块及各模块功能
-3. **字段智能推导**：为每个模块自动设计详细字段，包含数据类型、关联关系、字典需求
-4. **架构优化建议**：提供模块拆分、关联设计、扩展性等专业建议
-
-** 输出内容：**
-- 模块数量和架构设计
-- 每个模块的详细字段清单
-- 数据类型和关联关系设计
-- 字典需求和类型定义
-- 模块间关系图和扩展建议
-
-** 适用场景：**
-- 用户需求描述不完整，需要智能补全
-- 复杂业务系统的模块架构设计
-- 需要专业的数据库设计建议
-- 想要快速搭建生产级业务系统
-
-** 推荐工作流：**
- requirement_analyzer → gva_analyze → gva_execute → 其他辅助工具
- 
- `),
+		mcp.WithDescription(`智能需求分析器，作为GVA工具链首选入口。分析用户需求，设计模块架构和字段。
+
+**调用流程**: requirement_analyzer → gva_analyze → gva_execute
+
+**详细说明**: /gva-helper/requirement-analyzer`),
 		mcp.WithString("userRequirement",
 			mcp.Required(),
 			mcp.Description("用户的需求描述，支持自然语言，如：'我要做一个猫舍管理系统，用来录入猫的信息，并且记录每只猫每天的活动信息'"),
diff --git a/web/src/pathInfo.json b/web/src/pathInfo.json
@@ -60,6 +60,7 @@
   "/src/view/superAdmin/params/sysParams.vue": "SysParams",
   "/src/view/superAdmin/user/user.vue": "User",
   "/src/view/system/state.vue": "State",
+  "/src/view/systemTools/apiToken/index.vue": "Index",
   "/src/view/systemTools/autoCode/component/fieldDialog.vue": "FieldDialog",
   "/src/view/systemTools/autoCode/component/previewCodeDialog.vue": "PreviewCodeDialog",
   "/src/view/systemTools/autoCode/index.vue": "AutoCode",
@@ -72,7 +73,9 @@
   "/src/view/systemTools/formCreate/index.vue": "FormGenerator",
   "/src/view/systemTools/index.vue": "System",
   "/src/view/systemTools/installPlugin/index.vue": "Index",
+  "/src/view/systemTools/loginLog/index.vue": "Index",
   "/src/view/systemTools/pubPlug/pubPlug.vue": "PubPlug",
+  "/src/view/systemTools/skills/index.vue": "Skills",
   "/src/view/systemTools/sysError/sysError.vue": "SysError",
   "/src/view/systemTools/system/system.vue": "Config",
   "/src/view/systemTools/version/version.vue": "SysVersion",
