From 76fe71a8ddd8a4ff0ca0fa0126fa5ad36f372787 Mon Sep 17 00:00:00 2001 From: pixelmaxQM Date: Tue, 5 Aug 2025 20:35:12 +0800 Subject: [PATCH] =?UTF-8?q?docs(mcp):=20=E5=AE=8C=E5=96=84=E5=B7=A5?= =?UTF-8?q?=E5=85=B7=E6=8F=8F=E8=BF=B0=E5=B9=B6=E6=B7=BB=E5=8A=A0=E9=87=8D?= =?UTF-8?q?=E8=A6=81=E9=99=90=E5=88=B6=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- server/mcp/api_creator.go | 6 +++++- server/mcp/gva_auto_generate.go | 11 +++++++++++ server/mcp/menu_creator.go | 6 +++++- 3 files changed, 21 insertions(+), 2 deletions(-) diff --git a/server/mcp/api_creator.go b/server/mcp/api_creator.go index d2de59b5..1a1503d9 100644 --- a/server/mcp/api_creator.go +++ b/server/mcp/api_creator.go @@ -41,7 +41,11 @@ type ApiCreator struct{} // New 创建API创建工具 func (a *ApiCreator) New() mcp.Tool { return mcp.NewTool("create_api", - mcp.WithDescription("创建后端API记录，用于AI编辑器自动添加API接口时自动创建对应的API权限记录。注意：使用gva_auto_generate创建的包和模块会自动创建API权限，无需调用此工具。仅在AI编辑器自动添加API或router下的文件产生路径变化时使用。"), + mcp.WithDescription(`创建后端API记录，用于AI编辑器自动添加API接口时自动创建对应的API权限记录。 + +**重要限制：** +- 当使用gva_auto_generate工具且needCreatedModules=true时，模块创建会自动生成API权限，不应调用此工具 +- 仅在以下情况使用：1) 单独创建API（不涉及模块创建）；2) AI编辑器自动添加API；3) router下的文件产生路径变化时`), mcp.WithString("path", mcp.Required(), mcp.Description("API路径，如：/user/create"), diff --git a/server/mcp/gva_auto_generate.go b/server/mcp/gva_auto_generate.go index 527298dd..a710567c 100644 --- a/server/mcp/gva_auto_generate.go +++ b/server/mcp/gva_auto_generate.go @@ -135,6 +135,10 @@ func (t *AutomationModuleAnalyzer) New() mcp.Tool { 2. AI分析需求为1xxx2xxx格式 → gva_auto_generate（执行创建） 3. 创建完成后，根据需要使用其他辅助工具 +**重要限制：** +- 当needCreatedModules=true时，模块创建会自动生成API和菜单，因此不应再调用api_creator和menu_creator工具 +- 只有在单独创建API或菜单（不涉及模块创建）时才使用api_creator和menu_creator工具 + 重要：ExecutionPlan结构体格式要求（支持批量创建）： { "packageName": "包名(string)", @@ -1365,6 +1369,13 @@ func (t *AutomationModuleAnalyzer) executeCreation(ctx context.Context, plan *Ex } result.Message += fmt.Sprintf("批量创建完成，共处理 %d 个模块; ", len(plan.ModulesInfo)) + + // 添加重要提醒：不要使用其他MCP工具 + result.Message += "\n\n⚠️ 重要提醒：\n" + result.Message += "模块创建已完成，API和菜单已自动生成。请不要再调用以下MCP工具：\n" + result.Message += "- api_creator：API权限已在模块创建时自动生成\n" + result.Message += "- menu_creator：前端菜单已在模块创建时自动生成\n" + result.Message += "如需修改API或菜单，请直接在系统管理界面中进行配置。\n" } result.Message += "已构建目录结构信息; " diff --git a/server/mcp/menu_creator.go b/server/mcp/menu_creator.go index 4add855c..a5f83545 100644 --- a/server/mcp/menu_creator.go +++ b/server/mcp/menu_creator.go @@ -64,7 +64,11 @@ type MenuCreator struct{} // New 创建菜单创建工具 func (m *MenuCreator) New() mcp.Tool { return mcp.NewTool("create_menu", - mcp.WithDescription("创建前端菜单记录，用于AI编辑器自动添加前端页面时自动创建对应的菜单项。注意：使用gva_auto_generate创建的包和模块会自动创建菜单项，无需调用此工具。仅在AI编辑器自动添加前端页面时使用。"), + mcp.WithDescription(`创建前端菜单记录，用于AI编辑器自动添加前端页面时自动创建对应的菜单项。 + +**重要限制：** +- 当使用gva_auto_generate工具且needCreatedModules=true时，模块创建会自动生成菜单项，不应调用此工具 +- 仅在以下情况使用：1) 单独创建菜单（不涉及模块创建）；2) AI编辑器自动添加前端页面时`), mcp.WithNumber("parentId", mcp.Description("父菜单ID，0表示根菜单"), mcp.DefaultNumber(0),