技能介绍

解决什么问题

在 IDE 里操作 Bmob 数据库通常要在控制台、文档和代码之间来回切换。Bmob MCP Server 把 schema 查询、表结构变更、单条数据增删改查和 curl 样板生成统一到一个 MCP 工具集里，让你在 agent 对话窗口内完成这些操作，不需要手动拼 REST 请求。

核心能力

服务器暴露 7 个工具，覆盖开发期最常用的数据库操作：

get_project_tables：拉取当前项目所有表和字段结构，是所有写操作的前置步骤，不需要额外参数
create_table：新建数据表，fields 是 JSON 字符串，支持 String、Number、Bool、Date、File、Geo、Array、Object、Pointer、Relation 十种字段类型
add_single_data / update_single_data / delete_single_data：针对单条数据的增删改查，data 均为 JSON 字符串
generate_code：生成对应操作的 Bmob curl 命令，支持 13 种操作类型（增删改查、用户注册登录、云函数调用、文件上传等），方便翻译成任意语言的客户端代码
mcp_endpoint_mcp_post：服务器内部回环端点，不应主动调用

关键工作流

任何写操作前必须先调用 get_project_tables。Bmob 是 schemaless 数据库，add_single_data 接受任意 JSON，字段名拼错不会报错而是直接写入脏数据。Pointer 和 Relation 字段必须传 {"__type":"Pointer","className":"X","objectId":"..."} 格式，传字符串 objectId 会被静默忽略。

create_table 的 fields 里不要声明 createdAt、updatedAt、objectId、ACL——这些是 Bmob 内置字段。

update_single_data 用入参 data 整体替换给定字段，不是 patch 语义，调用前需确认目标数据。delete_single_data 不可逆，执行前必须向用户展示目标 objectId 与数据 diff 并经二次确认。

注意点

当前 MCP 端点是 HTTP 明文（非 HTTPS），X-Bmob-REST-API-Key 在传输中可被嗅探。仅建议本机开发环境使用，不要在公共 WiFi 下调用。含真实 Key 的配置文件（.cursor/mcp.json、.mcp.json、~/.codex/config.toml）必须加入 .gitignore，不要提交到公开仓库。

MCP 是开发期工具，agent → MCP 的链路不应嵌进生产应用。需要发布到 app 的生产代码请使用对应的 SDK skill（JavaScript、Android、iOS、RESTful），ACL 权限规则和云函数开发同理。