docs(mcp): 完善工具描述并添加重要限制说明
This commit is contained in:
@@ -41,7 +41,11 @@ type ApiCreator struct{}
|
|||||||
// New 创建API创建工具
|
// New 创建API创建工具
|
||||||
func (a *ApiCreator) New() mcp.Tool {
|
func (a *ApiCreator) New() mcp.Tool {
|
||||||
return mcp.NewTool("create_api",
|
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.WithString("path",
|
||||||
mcp.Required(),
|
mcp.Required(),
|
||||||
mcp.Description("API路径,如:/user/create"),
|
mcp.Description("API路径,如:/user/create"),
|
||||||
|
@@ -135,6 +135,10 @@ func (t *AutomationModuleAnalyzer) New() mcp.Tool {
|
|||||||
2. AI分析需求为1xxx2xxx格式 → gva_auto_generate(执行创建)
|
2. AI分析需求为1xxx2xxx格式 → gva_auto_generate(执行创建)
|
||||||
3. 创建完成后,根据需要使用其他辅助工具
|
3. 创建完成后,根据需要使用其他辅助工具
|
||||||
|
|
||||||
|
**重要限制:**
|
||||||
|
- 当needCreatedModules=true时,模块创建会自动生成API和菜单,因此不应再调用api_creator和menu_creator工具
|
||||||
|
- 只有在单独创建API或菜单(不涉及模块创建)时才使用api_creator和menu_creator工具
|
||||||
|
|
||||||
重要:ExecutionPlan结构体格式要求(支持批量创建):
|
重要:ExecutionPlan结构体格式要求(支持批量创建):
|
||||||
{
|
{
|
||||||
"packageName": "包名(string)",
|
"packageName": "包名(string)",
|
||||||
@@ -1365,6 +1369,13 @@ func (t *AutomationModuleAnalyzer) executeCreation(ctx context.Context, plan *Ex
|
|||||||
}
|
}
|
||||||
|
|
||||||
result.Message += fmt.Sprintf("批量创建完成,共处理 %d 个模块; ", len(plan.ModulesInfo))
|
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 += "已构建目录结构信息; "
|
result.Message += "已构建目录结构信息; "
|
||||||
|
@@ -64,7 +64,11 @@ type MenuCreator struct{}
|
|||||||
// New 创建菜单创建工具
|
// New 创建菜单创建工具
|
||||||
func (m *MenuCreator) New() mcp.Tool {
|
func (m *MenuCreator) New() mcp.Tool {
|
||||||
return mcp.NewTool("create_menu",
|
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.WithNumber("parentId",
|
||||||
mcp.Description("父菜单ID,0表示根菜单"),
|
mcp.Description("父菜单ID,0表示根菜单"),
|
||||||
mcp.DefaultNumber(0),
|
mcp.DefaultNumber(0),
|
||||||
|
Reference in New Issue
Block a user