Skip to content

Commit 76fe71a

Browse files
committed
docs(mcp): 完善工具描述并添加重要限制说明
1 parent 3f21d7f commit 76fe71a

File tree

3 files changed

+21
-2
lines changed

3 files changed

+21
-2
lines changed

server/mcp/api_creator.go

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,11 @@ type ApiCreator struct{}
4141
// New 创建API创建工具
4242
func (a *ApiCreator) New() mcp.Tool {
4343
return mcp.NewTool("create_api",
44-
mcp.WithDescription("创建后端API记录,用于AI编辑器自动添加API接口时自动创建对应的API权限记录。注意:使用gva_auto_generate创建的包和模块会自动创建API权限,无需调用此工具。仅在AI编辑器自动添加API或router下的文件产生路径变化时使用。"),
44+
mcp.WithDescription(`创建后端API记录,用于AI编辑器自动添加API接口时自动创建对应的API权限记录。
45+
46+
**重要限制:**
47+
- 当使用gva_auto_generate工具且needCreatedModules=true时,模块创建会自动生成API权限,不应调用此工具
48+
- 仅在以下情况使用:1) 单独创建API(不涉及模块创建);2) AI编辑器自动添加API;3) router下的文件产生路径变化时`),
4549
mcp.WithString("path",
4650
mcp.Required(),
4751
mcp.Description("API路径,如:/user/create"),

server/mcp/gva_auto_generate.go

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,10 @@ func (t *AutomationModuleAnalyzer) New() mcp.Tool {
135135
2. AI分析需求为1xxx2xxx格式 → gva_auto_generate(执行创建)
136136
3. 创建完成后,根据需要使用其他辅助工具
137137
138+
**重要限制:**
139+
- 当needCreatedModules=true时,模块创建会自动生成API和菜单,因此不应再调用api_creator和menu_creator工具
140+
- 只有在单独创建API或菜单(不涉及模块创建)时才使用api_creator和menu_creator工具
141+
138142
重要:ExecutionPlan结构体格式要求(支持批量创建):
139143
{
140144
"packageName": "包名(string)",
@@ -1365,6 +1369,13 @@ func (t *AutomationModuleAnalyzer) executeCreation(ctx context.Context, plan *Ex
13651369
}
13661370

13671371
result.Message += fmt.Sprintf("批量创建完成,共处理 %d 个模块; ", len(plan.ModulesInfo))
1372+
1373+
// 添加重要提醒:不要使用其他MCP工具
1374+
result.Message += "\n\n⚠️ 重要提醒:\n"
1375+
result.Message += "模块创建已完成,API和菜单已自动生成。请不要再调用以下MCP工具:\n"
1376+
result.Message += "- api_creator:API权限已在模块创建时自动生成\n"
1377+
result.Message += "- menu_creator:前端菜单已在模块创建时自动生成\n"
1378+
result.Message += "如需修改API或菜单,请直接在系统管理界面中进行配置。\n"
13681379
}
13691380

13701381
result.Message += "已构建目录结构信息; "

server/mcp/menu_creator.go

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,11 @@ type MenuCreator struct{}
6464
// New 创建菜单创建工具
6565
func (m *MenuCreator) New() mcp.Tool {
6666
return mcp.NewTool("create_menu",
67-
mcp.WithDescription("创建前端菜单记录,用于AI编辑器自动添加前端页面时自动创建对应的菜单项。注意:使用gva_auto_generate创建的包和模块会自动创建菜单项,无需调用此工具。仅在AI编辑器自动添加前端页面时使用。"),
67+
mcp.WithDescription(`创建前端菜单记录,用于AI编辑器自动添加前端页面时自动创建对应的菜单项。
68+
69+
**重要限制:**
70+
- 当使用gva_auto_generate工具且needCreatedModules=true时,模块创建会自动生成菜单项,不应调用此工具
71+
- 仅在以下情况使用:1) 单独创建菜单(不涉及模块创建);2) AI编辑器自动添加前端页面时`),
6872
mcp.WithNumber("parentId",
6973
mcp.Description("父菜单ID,0表示根菜单"),
7074
mcp.DefaultNumber(0),

0 commit comments

Comments
 (0)