| name | bmob-mcp |
| description | Use when the user has the Bmob MCP server configured (http://mcp.bmobapp.com/mcp) and wants to perform LIVE operations against their Bmob backend cloud project from the IDE. Triggers: 'list bmob tables', 'show bmob schema', 'create bmob table', 'add a row to bmob', 'update bmob record', 'delete bmob data', '生成 bmob curl', 'design bmob schema', '上传云函数', '部署云函数', '发布云函数', '调用云函数', '执行云函数', 'invoke cloud function', 'run cloud function', '一键部署网站', '静态托管', '部署静态站点', 'deploy static site', 'deploy website'. Provides 10 tools: get_project_tables (ALWAYS call first to discover schema before any write), create_table (10 field types String/Number/Bool/Date/File/Geo/Array/Object/Pointer/Relation), add_single_data, update_single_data, delete_single_data, generate_code (emits curl for 15 operation types incl. auth/sms/cloud-function/static-site-deploy), deploy_cloud_function (PUT api.codenow.cn/1/functions), invoke_cloud_function (POST api.codenow.cn/1/functions), deploy_static_site (one-click HTML or dist.zip to CDN), mcp_endpoint_mcp_post. NOT for writing client/SDK code that will ship in the user's app — for that use bmob-database-{javascript,android,ios,swift,flutter,restful}. NOT for ACL / role design (use bmob-acl-and-roles) or cloud function development (use bmob-cloud-function-development). |
| metadata | {"author":"bmob","version":"0.2.0","mcp_endpoint":"http://mcp.bmobapp.com/mcp","protocol":"2024-11-05","transport":"http+sse","homepage":"https://www.bmobapp.com/mcp"} |
Bmob MCP Server
Bmob 官方托管的 MCP 服务器，端点 http://mcp.bmobapp.com/mcp，传输是 MCP 2024-11-05 的 HTTP+SSE。通过 X-Bmob-Application-Id + X-Bmob-REST-API-Key 两个 HTTP 头部鉴权，agent 配置好后即可在 IDE 内对你的真实 Bmob 项目进行增删改查、设计 schema、生成 curl 样板。
操作级路由：MCP 工具 vs generate_code vs SDK/REST 的对照表见 shared/operation-routing.md。
工具数量：tools/list 返回 10 个；agent 调用 9 个（不含内部工具 mcp_endpoint_mcp_post）。
HTTP 明文警告：当前 MCP 端点是 HTTP（非 HTTPS）。仅建议在本机开发环境使用；请勿把含真实 Key 的 .cursor/mcp.json / .mcp.json 提交进公开 git 仓库。
何时用 MCP vs 何时用 SDK skill
| 场景 | 走 MCP | 走 SDK skill |
|---|
| 想知道项目里有哪些表、字段是什么类型 | ✅ get_project_tables | — |
| 设计新表 / 增字段 / 改 schema | ✅ create_table | — |
| 在 IDE 里测试增删改查（开发期手工触发） | ✅ add_single_data / update_single_data / delete_single_data | — |
| 上传 / 部署云函数源码并验证 | ✅ deploy_cloud_function；单独执行 → invoke_cloud_function | — |
执行 / 试跑云函数（REST POST /1/functions/<name>） | ✅ invoke_cloud_function；生成 curl → generate_code（调用云函数） | — |
| 一键部署网站 / 静态托管（单页 HTML 或 dist.zip 到 CDN） | ✅ deploy_static_site 或 generate_code（部署静态站点单页 / 部署静态站点dist） | — |
| 想要任意语言的 curl 样板（备份、迁移脚本） | ✅ generate_code | — |
| 写到 app 里要发布的代码（生产代码） | — | ✅ bmob-database-{javascript,android,ios,swift,flutter,restful} |
| 配 ACL / 权限规则 | — | ✅ bmob-acl-and-roles |
| 写运行在 Bmob 服务器上的云函数 | — | ✅ bmob-cloud-function-development |
安装
把以下任一片段复制到对应工具的 MCP 配置文件，详细见 shared/mcp-install-snippets.md：
{
"mcpServers": {
"bmob": {
"url": "http://mcp.bmobapp.com/mcp",
"headers": {
"X-Bmob-Application-Id": "<your-application-id>",
"X-Bmob-REST-API-Key": "<your-rest-api-key>"
}
}
}
}
凭证位置：Bmob 控制台 → 你的应用 → 设置 / 应用密钥。
强制工作流
任何写操作前必须先调用 get_project_tables 拿到当前项目的真实表结构，禁止凭推测生成字段名 / 类型。这是因为：
- Bmob 是 schemaless 的——
add_single_data 接受任意 JSON，错字段会直接进库导致脏数据。
Pointer / Relation 字段必须传 { "__type":"Pointer", "className":"X", "objectId":"..." } 格式，写错会被静默忽略。
sequenceDiagram
autonumber
participant U as User
participant A as Agent
participant M as Bmob MCP
U->>A: "帮我给 Player 表加一条数据 Lily, 18 岁"
A->>M: get_project_tables (always first)
M-->>A: {Player: {name:String, age:Number, ...}}
A->>U: 确认字段对应 + 数据示例
U-->>A: 确认
A->>M: add_single_data {tableName:"Player", data:"{\"name\":\"Lily\",\"age\":18}"}
M-->>A: {createdAt:..., objectId:...}
A->>U: 写入成功，objectId=...
10 个工具的真实 schema（9 个供 agent 调用）
tools/list 共 10 个；不要调用第 10 个 mcp_endpoint_mcp_post（服务端内部回环）。下方 1–9 为 agent 可用工具。
1. get_project_tables
获取这个项目的所有表和对应的字段结构。除 headers 之外不需要传任何参数。所有写操作前必须先调用一次。
{
"inputSchema": {
"type": "object",
"properties": {},
"title": "get_project_tablesArguments"
}
}
2. create_table
创建新的数据表。
{
"inputSchema": {
"type": "object",
"properties": {
"tableName": { "type": "string" },
"classNote": { "type": "string" },
"fields": { "type": "string", "description": "JSON-encoded field map" }
}
}
}
fields 是 JSON 字符串，示例：
{
"score": { "type": "Number", "isAutoIncre": true, "autoIncreInit": 1000, "note": "游戏分数" },
"player": { "type": "Pointer", "targetClass": "Player", "note": "玩家" },
"nickname": { "type": "String", "unique": true, "note": "昵称" }
}
type 是 10 个枚举值之一：
| type | 说明 | 额外约束 |
|---|
String | 字符串 | unique: true 可设唯一键 |
Number | 整数 / 小数 | isAutoIncre: true + autoIncreInit: <int> 可设自增 |
Bool | 布尔 | — |
Date | 日期 | — |
File | 文件 | 关联 Bmob 文件系统的 url + filename |
Geo | 地理位置 | latitude + longitude |
Array | 数组 | — |
Object | 嵌套对象 | — |
Pointer | 一对多指针 | 必填 targetClass: "<TableName>" |
Relation | 多对多关联 | 必填 targetClass: "<TableName>" |
重要：createdAt / updatedAt / objectId / ACL 是 Bmob 内置字段，不要在 fields 里声明它们。
3. add_single_data
给指定表添加一行数据。
{
"inputSchema": {
"type": "object",
"required": ["tableName", "data"],
"properties": {
"tableName": { "type": "string" },
"data": { "type": "string", "description": "JSON-encoded row" }
}
}
}
data 是 JSON 字符串，例：'{"score":1337,"playerName":"bmob","cheatMode":false}'。Pointer 字段用：
{ "player": { "__type": "Pointer", "className": "Player", "objectId": "abc123" } }
4. update_single_data
更新某行数据。会用入参 data 整体替换给定字段（不是 patch）。
{
"inputSchema": {
"type": "object",
"required": ["tableName", "objectId", "data"],
"properties": {
"tableName": { "type": "string" },
"objectId": { "type": "string" },
"data": { "type": "string" }
}
}
}
5. delete_single_data
删除某表中指定 objectId 的一行。不可逆，调用前必须经用户二次确认。
{
"inputSchema": {
"type": "object",
"required": ["tableName", "objectId"],
"properties": {
"tableName": { "type": "string" },
"objectId": { "type": "string" }
}
}
}
6. generate_code
生成对应操作的 Bmob curl，便于客户端把 curl 翻译成任意开发语言。调用前必须先调用 get_project_tables。type 是 15 个枚举值，每种 type 需要的参数子集不同：
type 取值 | 必填参数 |
|---|
添加 | tableName, data |
删除 | tableName, objectId |
更新 | tableName, objectId, data |
查询一条数据 | tableName, objectId |
条件查询 | tableName, where（JSON 字符串）, skip, limit, count |
注册 | data（必含 username + password） |
用户名密码登录 | username, password |
手机号验证码登录 | mobilePhoneNumber, smsCode |
更新用户 | sessionToken, objectId, data |
请求短信验证码 | data（必含 mobilePhoneNumber + template） |
验证短信验证码 | data（必含 mobilePhoneNumber）, smsCode |
调用云函数 | funcName, data（无参时 data 必须为 {}） |
上传文件 | fileName, content_Type |
部署静态站点单页 | fileName（如 index.html，默认 index.html） |
部署静态站点dist | fileName（如 dist.zip，默认 dist.zip） |
完整 inputSchema：
{
"inputSchema": {
"type": "object",
"required": ["type", "objectId", "data", "tableName", "where"],
"properties": {
"type": { "type": "string" },
"objectId": { "type": "string" },
"data": { "type": "string" },
"tableName": { "type": "string" },
"where": { "type": "string" },
"skip": { "type": "integer" },
"limit": { "type": "integer" },
"count": { "type": "integer" },
"fileName": { "type": "string" },
"content_Type": { "type": "string" },
"username": { "type": "string" },
"password": { "type": "string" },
"mobilePhoneNumber": { "type": "string" },
"smsCode": { "type": "string" },
"sessionToken": { "type": "string" },
"funcName": { "type": "string" }
}
}
}
where 示例：'{"age":{"$gte":18}}' 等同 SQL WHERE age >= 18。完整 where 语法见 REST 文档 #_24。
7. deploy_cloud_function
上传 / 部署云函数：将 JavaScript 或 Java 云函数源码上传到 Bmob，并可选立即验证。
触发词：上传云函数、部署云函数、发布云函数、写云函数并验证。
{
"inputSchema": {
"type": "object",
"required": ["funcName", "code"],
"properties": {
"funcName": { "type": "string", "description": "云函数名称，如 rsync_img" },
"code": { "type": "string", "description": "云函数源码原文" },
"language": { "type": "integer", "description": "1=javascript, 2=java" },
"comment": { "type": "string", "description": "可选备注" },
"verify": { "type": "integer", "description": "1 表示上传成功后立即验证" },
"verify_data": { "type": "string", "description": "验证入参 JSON 字符串，默认 \"{}\"" }
}
}
}
- 上传上游：
PUT https://api.codenow.cn/1/functions/{funcName}
- 验证上游：
POST https://api.codenow.cn/1/functions/{funcName}
- 语言：
1 为 JavaScript，2 为 Java
- 自动验证：
verify=1 时，上传成功后会继续用 verify_data 执行该函数
- 部署成功后的调用说明：响应含
invokeGuide（REST curl 含 headers、各端 SDK 样板、skillRouting）。向用户展示时禁止裸 URL，须按当前项目类型从 invokeGuide.sdk 选一种示例，REST 优先用 invokeGuide.rest.curl
- 详细说明见 MCP 项目
docs/deploy-cloud-function.md
8. invoke_cloud_function
执行云函数：通过 REST API 调用已部署的云函数并返回结果。
触发词：调用云函数、执行云函数、invoke cloud function、run cloud function。
{
"inputSchema": {
"type": "object",
"required": ["funcName"],
"properties": {
"funcName": { "type": "string", "description": "云函数名称，如 rsync_img" },
"data": { "type": "string", "description": "JSON 参数字符串，无参传 \"{}\"" }
}
}
}
- 上游：
POST https://api.codenow.cn/1/functions/{funcName}
- 鉴权：沿用 MCP 配置的
X-Bmob-Application-Id + X-Bmob-REST-API-Key
- 无参：
data 必须为 {}
- 仅需 curl 样板、不自动执行时，用
generate_code → 调用云函数
- 详细说明见 MCP 项目
docs/invoke-cloud-function.md
9. deploy_static_site
一键部署网站 / 静态托管：将单页 HTML 或 dist 压缩包部署到 Bmob CDN。
触发词：一键部署网站、静态托管、部署静态站点、部署网站、上传 dist、托管 HTML。
{
"inputSchema": {
"type": "object",
"required": ["fileName"],
"properties": {
"fileName": { "type": "string", "description": "仅允许 .zip / .html / .htm，如 index.html 或 dist.zip" }
}
}
}
- 方法：
POST，请求体为文件二进制
- 单页 HTML：
fileName=index.html，Content-Type: text/html
- 整站 dist：
fileName=dist.zip，Content-Type: application/zip
- 非法后缀返回
{"code": 158, "error": "file must be zip or html"}
- 详细说明见 MCP 项目
docs/deploy-static-site.md
10. mcp_endpoint_mcp_post
服务器内部回环端点，不要主动调用。
常见问题
跨平台 Q&A：shared/faq.md（含 MCP 工具选择与 mcp_endpoint_mcp_post 说明）。
反模式
见 shared/anti-patterns.md（尤其：MCP 嵌生产、HTTP 明文传 Key）。
应用场景食谱
静态站部署：shared/recipes/static-site-deploy.md。
安全清单
常见错误
| 表现 | 原因 | 修复 |
|---|
tools/list 报 -32602 Invalid request parameters | 没有先 initialize + notifications/initialized 握手 | MCP client 默认会做，手测可参考下方诊断片段 |
| Header 401 / 403 | App ID 或 REST API Key 写错；或者 App ID 与 Key 不属于同一应用 | 控制台重取，注意"测试环境 / 生产环境"密钥不同 |
add_single_data 成功但数据不出现 | 字段名拼错（schemaless 不报错） | 先 get_project_tables 拿真实字段名 |
| Pointer 字段不生效 | 传成了字符串 objectId | 改用 {"__type":"Pointer","className":"X","objectId":"..."} |
诊断片段（手测 SSE 连接）
仅供开发者验证 MCP 服务器连通性使用，正常情况下 agent 自动处理。
curl -s -N 'http://mcp.bmobapp.com/mcp' \
-H 'Accept: text/event-stream' \
-H 'X-Bmob-Application-Id: <id>' \
-H 'X-Bmob-REST-API-Key: <key>' &
curl -s -X POST 'http://mcp.bmobapp.com/mcp/messages/?session_id=xxx' \
-H 'Content-Type: application/json' \
-H 'X-Bmob-Application-Id: <id>' \
-H 'X-Bmob-REST-API-Key: <key>' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0.1"}}}'
参考
