明道云 MCP 工具调用失败 BUG 报告

问题描述

在使用明道云 MCP（开放平台）工具时，存在以下问题：

1. 工具不可用：调用 create_worksheet 工具时，收到错误信息："Tool's name mcp_hap-mcp-129_create_worksheet is not available in given tool list"
2. 工具路由错误：每次调用 create_worksheet 工具时，实际显示调用的都是 Create_roles 工具

环境信息

• 操作系统：Windows
• Node.js 版本：v24.13.1（符合 MCP 要求的 >=18.0.0）
• 项目目录：d:\Coding\129
• MCP 配置：已在项目根目录创建 mcp.json 文件

MCP 服务器日志

根据 MCP 服务器日志，服务器端已配置以下工具（共 41 个）：

trigger_workflow, get_app_worksheets_list, get_record_relations, get_record_discussions, 
delete_worksheet, update_worksheet, get_time, batch_delete_records, create_role, 
get_role_details, get_workflow_details, create_record, batch_create_records, 
update_record, get_workflow_list, get_regions, find_department, get_app_knowledge_list, 
get_record_logs, get_app_info, get_approval_list_by_row, batch_update_records, 
remove_member_from_role, get_record_share_link, delete_role, delete_record, 
get_role_list, find_member, leave_all_roles, get_worksheet_structure, 
knowledge_search, delete_optionset, get_record_list, get_record_pivot_data, 
create_optionset, get_record_details, get_optionset_list, create_worksheet, 
add_member_to_role, update_optionset, get_approval_detail

可正常工作的工具

以下工具调用成功：

• get_app_info：获取应用信息 ✓
• get_workflow_list：获取工作流列表 ✓
• create_optionset：创建选项集 ✓（之前成功创建了"政治面貌"和"性别"选项集）

无法正常工作的工具

以下工具调用失败：

• create_worksheet：创建工作表 ✗
• create_role：创建角色 ✗（参数验证失败）

尝试的参数格式

1. create_worksheet

{
  "name": "组织表",
  "description": "存储组织的基本信息",
  "fields": [{"name": "组织名称", "type": "Text", "required": true}]
}

结果：工具不存在

2. create_worksheet（尝试 worksheet_前缀）

{
  "worksheet_name": "组织表",
  "worksheet_description": "存储组织的基本信息",
  "fields": [{"field_name": "组织名称", "field_type": "Text", "required": true}]
}

结果：工具不存在

3. create_role

{
  "name": "测试角色",
  "description": "测试角色描述",
  "type": "0",
  "permissionScope": "0"
}

结果：参数验证失败，错误码 10002

异常现象

1. 工具路由错误：每次调用 create_worksheet 工具时，实际显示调用的都是 Create_roles 工具
2. 参数验证失败：调用 create_role 工具时，收到"The request parameter is invalid"错误

推测原因

1. 工具名称格式问题：可能需要特定的前缀或格式才能正确调用工具
2. 参数格式问题：可能需要特定的参数格式才能通过验证
3. 工具权限问题：可能部分工具需要特定的权限才能调用

建议

请明道云技术团队确认：

1. create_worksheet 工具的正确调用方式和参数格式
2. create_role 工具的参数验证失败原因
3. 为什么调用 create_worksheet 时会路由到 Create_roles