优康云 MCP Server 文档

MCP Server 的目标，是让 OpenCode、Codex、千问、豆包等 AI 工具可以调用优康云安装能力。所有安装、检测、开户注册、绑定、诊断操作都通过明确工具暴露。任何失败必须返回明确错误码和原因，不允许静默吞错。

当前状态：MCP Server 正在升级。第一阶段开放文档、工具协议和 Manifest 描述，后续逐步开放真实工具执行能力。

安全边界：涉及安装、写入配置、开户注册、绑定云端的工具必须进行权限检查、参数校验和审计记录。机构开户注册不得绕过待审核或验证码确认流程。

建议工具列表

工具	输入	输出	失败原因
`check_environment`	无，或指定端口/安装目录。	OS、内存、磁盘、端口、运行库、MySQL、权限检查结果。	`OS_UNSUPPORTED`、`PORT_OCCUPIED`、`RUNTIME_MISSING`、`PERMISSION_DENIED`
`install_mysql84`	安装包来源、端口、数据目录；密码从安全输入或本机密钥库获取。	服务名、端口、版本、安装路径、初始化结果。	`DOWNLOAD_FAILED`、`SHA256_MISMATCH`、`PORT_OCCUPIED`、`SERVICE_CREATE_FAILED`
`install_health_exam`	安装目录、数据库连接引用、服务端口、版本通道。	安装版本、访问地址、服务状态、日志路径。	`PACKAGE_NOT_FOUND`、`DB_UNREACHABLE`、`CONFIG_WRITE_FAILED`、`HEALTH_CHECK_FAILED`
`register_org`	机构名称、联系人、手机号、统一社会信用代码、许可证资料引用。	申请编号、审核状态、下一步动作。	`VALIDATION_FAILED`、`SMS_VERIFY_REQUIRED`、`MANUAL_REVIEW_REQUIRED`、`DUPLICATE_ORG`
`bind_cloud`	机构编码、一次性绑定令牌或云端授权结果。	绑定状态、网关配置引用、审计编号。	`ORG_NOT_APPROVED`、`TOKEN_EXPIRED`、`BINDING_DENIED`、`AUDIT_WRITE_FAILED`
`install_gateway`	安装目录、云端配置引用、机构编码。	网关服务状态、同步地址、报告上传策略。	`CONFIG_MISSING`、`SERVICE_START_FAILED`、`CLOUD_UNREACHABLE`
`diagnose`	诊断范围，可选组件列表。	问题清单、错误码、建议处理方式。	`INSPECTION_TIMEOUT`、`LOG_READ_FAILED`
`get_install_report`	报告格式、是否包含日志摘要。	安装时间、版本号、数据库连接摘要、开放端口、配置项、异常项。	`REPORT_GENERATE_FAILED`、`AUDIT_READ_FAILED`

统一返回格式

{
  "success": false,
  "errorCode": "SHA256_MISMATCH",
  "message": "安装包校验失败，请重新获取下载授权。",
  "details": {
    "component": "mysql84-runtime",
    "expectedSha256": "...",
    "actualSha256": "..."
  },
  "auditId": "AUD-20260524-000001"
}

典型调用链

check_environment
install_mysql84
install_health_exam
register_org
bind_cloud
install_gateway
diagnose
get_install_report

AI 应先读取 https://www.ukang.cc/manifest/ukang-agent-manifest.json，根据组件状态、SHA256、依赖关系和命令状态判断是否可以执行下一步。

返回 AI 安装页面