mcpField
B
bkend-data

bkend-data

github.com/ww-w-ai数据与数据库60645 次安装4 周前更新
代码仓库

关于 bkend-data

介绍 bkend.ai 数据库操作的参考技能，涵盖表结构、记录、筛选和索引。除 REST 数据 API 外，也整理了用于开发流程的 MCP 工具。

主要功能

  1. 01七种字段类型与约束
  2. 02管理数据表及结构版本
  3. 03记录增删改查、筛选与分页
  4. 04关联关系与联表查询
  5. 05单字段及复合索引

适用场景

  1. 01定义数据表结构与字段
  2. 02通过 MCP 工具管理记录
  3. 03筛选、排序和分页数据
  4. 04通过联表查询获取关联记录

MCP 相关

介绍用于数据表和字段管理、结构与索引版本管理及记录增删改查的 MCP 工具，也说明如何通过 MCP 文档工具获取工具结构和指南。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ww-w-ai/bkit-claude-code --skill bkend-data

安装后在 Claude Code 中输入/bkend-data确认已加载。

详细介绍

bkend.ai 数据库指南

列类型（7 种）

类型描述示例
String文本name, email
Number数值age, price
Boolean真/假isActive
Date日期/时间birthDate
Array数组tags: ["a","b"]
Object嵌套对象address: {city, zip}
Mixed任意类型metadata

约束

  • required：字段必须有值
  • unique：不允许重复值
  • default：未提供时使用的默认值

自动系统字段

字段类型描述
idString自动生成的唯一 ID
createdByString创建者用户 ID
createdAtDate创建时间戳
updatedAtDate最后更新时间戳

重要：bkend 在所有 API 响应中使用 id（而非 _id）。

MCP 表管理工具

工具用途范围
backend_table_create创建表table:create
backend_table_list列出表table:read
backend_table_get获取表详情和架构table:read
backend_table_delete删除表table:delete
backend_field_manage添加/修改/删除字段table:update
backend_index_manage管理索引table:update
backend_schema_version_list架构版本历史table:read
backend_schema_version_get架构版本详情table:read
backend_schema_version_apply应用架构版本（回滚）table:update
backend_index_version_list索引版本历史table:read
backend_index_version_get索引版本详情table:read

MCP 数据 CRUD 工具

工具用途关键参数
backend_data_list列出记录（筛选、排序、分页）tableId, page?, limit?, sortBy?, sortDirection?, andFilters?, orFilters?
backend_data_get获取单条记录tableId, recordId
backend_data_create创建记录tableId, data: { field: value }
backend_data_update部分更新记录tableId, recordId, data: { field: value }
backend_data_delete删除记录tableId, recordId

所有数据 CRUD 工具都需要：organizationId、projectId、environmentId（来自 get_context）。

筛选运算符
运算符含义示例
$eq等于{ "status": { "$eq": "active" } }
$ne不等于{ "role": { "$ne": "admin" } }
$gt / $gte大于 / >={ "age": { "$gt": 18 } }
$lt / $lte小于 / <={ "price": { "$lt": 100 } }
$in / $nin在数组中 / 不在数组中{ "tag": { "$in": ["a","b"] } }

MCP 指南文档（通过 search_docs）

使用 search_docs 工具访问以下指南：

文档 ID内容
4_howto_implement_data_crudCRUD 实现模式
7_code_examples_dataCRUD 和文件上传代码示例

使用 get_operation_schema 获取任意工具的输入/输出架构。

REST 数据 API

方法端点描述
GET/v1/data/{table}列出（筛选、排序、分页、限制）
POST/v1/data/{table}创建
GET/v1/data/{table}/{id}获取单条记录
PATCH/v1/data/{table}/{id}部分更新
DELETE/v1/data/{table}/{id}删除

筛选

  • 文本搜索：?search=keyword
  • AND 筛选：?filter[field1]=value1&filter[field2]=value2
  • 比较运算符：$eq、$ne、$gt、$gte、$lt、$lte、$in、$nin
  • 排序：?sort=field:asc（或 desc）
  • 分页：?page=1&limit=20（默认 20，最大 100）

关系与联接

  • 配置表关系
  • 通过联接查询检索相关数据

索引管理

  • 创建单字段/复合索引
  • 通过 MCP backend_index_manage 管理
  • 对优化查询性能至关重要

官方文档（实时参考）

如需查看最新数据库文档，请使用 WebFetch：

评论

支持 Markdown