用途:当智能体需要经由 MCP 工具操作 CloudBase 关系型数据库时使用,例如查询或检查表数据、修改数据或表结构(INSERT/UPDATE/DELETE/DDL)、读取或更改表安全规则。不适用于构建访问该数据库的 Web 或 Node.js 应用,也不涉及认证流程或用户身份。
主要能力:仅支持四个 MCP 工具。executeReadOnlySQL 用于运行只读 SELECT(列出行、聚合、连接,变更前检查数据);executeWriteSQL 用于写或 DDL 语句(INSERT、UPDATE、DELETE、CREATE TABLE、ALTER TABLE、DROP TABLE),可用于数据迁移、修正或初始化数据、结构变更;readSecurityRule 读取指定表的安全规则;writeSecurityRule 设置或更新表安全规则。安全规则类型通常包括 READONLY、PRIVATE、ADMINWRITE、ADMINONLY、CUSTOM。
使用方式:若可调用上述四个工具,即处于 MCP 上下文,此时不要初始化该数据库的 SDK。按任务选择工具:读用 executeReadOnlySQL,写或 DDL 用 executeWriteSQL,查规则用 readSecurityRule,改规则用 writeSecurityRule。破坏性操作(DELETE、DROP 等)前先说明将执行什么及原因,并优先用只读 SELECT 验证假设。新建表必须包含 _openid 列:_openid VARCHAR(64) DEFAULT '' NOT NULL;用户登录时该字段由服务器按当前身份自动填充,无需在 INSERT 中手动设置。调用写入工具前确认目标表与条件正确,必要时先执行对应 SELECT。
适用场景:安全查看表数据(带 LIMIT 与条件过滤的 SELECT);应用表结构变更(先检查、再规划、单次执行、可再 SELECT 验证);收紧敏感表安全规则(先读、确定目标规则、说明原因、写入、可复读确认)。
限制:调用前需说明意图,优先使用标准规则类型而非 CUSTOM。MCP 工具用于智能体操作与数据库管理,不依赖应用认证状态;应用代码应使用对应 SDK 路径(前端 Web 用 Web 关系型数据库技能,后端 Node 用 Node 快速上手),避免在同一流程中混用 MCP 工具与 SDK 初始化。资料未提供计费、价格、平台限制等信息。