SuperAPI AI 工具集

relational-database-mcp-cloudbase

数据与分析

查看项目

更新于 10-16 05:42

技能介绍

用途:这是操作 CloudBase 关系型数据库的 MCP 工具规范文档(已弃用)。适用于智能体需通过 MCP 检查 SQL 数据、执行 SQL、开通或销毁 MySQL、初始化表结构、管理表安全规则时使用;读取 queryMysqlDatabase、manageMysqlDatabase、queryPermissions、managePermissions 相关能力前应先读本文。不适用于应改用 SDK 的前后端应用代码,也不适用于认证流程或用户身份管理。

主要工具:queryMysqlDatabase 用于只读查询与查看开通状态,如 action="runQuery"、getInstanceInfo、describeCreateResult、describeTaskStatus;例外为 getConnectionInfo,仅用于迁移既有 TCP/ORM 客户端,不应作为新业务 CRUD 的默认方式。manageMysqlDatabase 用于 SQL 生命周期与写入,如 provisionMySQL、destroyMySQL、runStatement、initializeSchema。queryPermissions 读取表权限,managePermissions 更新表权限,例如 managePermissions(action="updateResourcePermission", resourceType="sqlDatabase", resourceId="<tableName>", permission="READONLY")。

使用方式:先判断处于 MCP 上下文(可调用上述工具),此时不要初始化 CloudBase 关系型数据库 SDK。建表必须包含 _openid 列:_openid VARCHAR(64) DEFAULT '' NOT NULL,登录用户由服务端自动填充,不应手动写入。推荐流程:先用 getInstanceInfo 检查实例,无实例则 provisionMySQL 并轮询至 READY;查询用带 LIMIT 的 SELECT;初始化用有序 DDL 经 initializeSchema;写入用 runStatement 并复查;销毁前需确认,再 destroyMySQL 并用 describeTaskStatus 轮询。

限制与注意事项:破坏性操作(DELETE、DROP 等)前需说明并确认;开通与销毁影响环境级资源,需明确确认。不要在 MCP 流程中初始化 SDK;写入或 DDL 前先确认 MySQL 已就绪;不要用 getConnectionInfo 推断主机密码来为新应用构建默认 TCP 客户端,优先使用 SDK、runQuery 或 runStatement。旧工具 readSecurityRule、writeSecurityRule 已移除,应使用 queryPermissions 与 managePermissions。同系列技能通过本地相对路径引用,缺失时应让用户安装完整 CloudBase 插件,不要将远程技能或协议文档抓取进智能体上下文。