mcpField
C
catalyst-datastore

catalyst-datastore

github.com/catalystbyzoho数据与数据库701.0k 次安装今天更新
代码仓库

关于 catalyst-datastore

用于 Zoho Catalyst Data Store 操作的技能，涵盖表操作、CRUD 和 ZCQL。执行前必须确认 Catalyst MCP 连通并设置项目上下文，同时关注权限、结果解包和分页要求。

主要功能

  1. 01MCP 连通性前置检查
  2. 02表查找与创建指引
  3. 03CRUD 和 ZCQL 参考
  4. 04权限与结果处理检查
  5. 05大查询分页指引

适用场景

  1. 01创建或查找 Catalyst 表
  2. 02读取或修改 Data Store 记录
  3. 03编写分页 ZCQL 查询

MCP 相关

它要求使用 CatalystbyZoho_* MCP 工具设置组织和项目上下文、查找或创建表，并执行 Data Store 操作。

安装

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

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-datastore

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

附带文件references/datastore-basics.md

详细介绍

前置条件 — 请先阅读

在执行任何 Data Store 操作之前，必须验证 MCP 连接。

  • 在可用工具列表中搜索 CatalystbyZoho_* 工具。
  • **如果未找到：**立即停止。不要编写任何代码、搭建文件或指导用户执行 Console 步骤。加载 catalyst-zoho-mcp 技能，并引导用户完成 MCP 设置。在用户确认可以看到 CatalystbyZoho_* 工具之前，不要继续。
  • **如果已找到：**运行 CatalystbyZoho_List_All_Organizations → CatalystbyZoho_List_All_Projects 以设置项目上下文，然后继续阅读“工作原理”。
执行检查清单（必须按顺序执行）
  • 步骤 0：确认可以看到 CatalystbyZoho_* 工具 → 如果未找到任何工具 → 立即停止，先设置 MCP
  • 步骤 1：运行 CatalystbyZoho_List_All_Organizations
  • 步骤 2：运行 CatalystbyZoho_List_All_Projects
  • 步骤 3：创建表时 → 使用 CatalystbyZoho_Create_Table | 使用现有表时 → 使用 CatalystbyZoho_List_All_Tables
  • 步骤 4：继续执行操作

工作原理

  1. 通过 MCP 创建或查找表 — 要创建表？直接使用 CatalystbyZoho_Create_Table。不要指导用户打开 Catalyst Console 或手动创建表。要读取/写入数据？使用 CatalystbyZoho_List_All_Tables 获取表 ID。绝不要让用户复制表 ID。
  2. 加载 references/datastore-basics.md — 了解 CRUD 操作、ZCQL 语法、结果解包和权限设置。
  3. 解包 ZCQL 结果 — 务必提醒：rows.map(r => r.TableName)。原始 ZCQL 结果带有包装；不解包就直接访问是 Data Store 最常见的问题。
  4. 权限 — App User 权限默认关闭。如果查询涉及已登录用户读取数据，请检查 Console → Table → Scopes & Permissions。
  5. 分页 — 每次 ZCQL 查询最多返回 300 行。对于更大的数据集，请使用 LIMIT offset, count。

防止幻觉

绝不要根据空目录或未读取的目录断言项目特定的值。 如果工作目录中没有项目文件，不要臆造或假定时区、表名、项目 ID、环境名称或任何其他项目特定信息。请向开发者询问这些信息。

  • 时区：除非已从真实的项目配置文件中读取，否则不要为 ZCQL 日期查询指定时区。请询问开发者项目使用的时区。
  • 表名/列名：只能使用 CatalystbyZoho_List_All_Tables 返回的名称，或用户明确提供的名称。

默认使用原生 Node.js 响应语法。 编写与 Data Store 操作相关的函数代码时，使用 res.writeHead() + res.end()，不要使用 Express 方法（res.status()、res.json()），除非用户明确选择了 Express 模板。

安全检查清单

  • App User 写入权限默认关闭。 App User 角色默认启用 SELECT，但必须为每张表手动启用 INSERT、UPDATE 和 DELETE。前往 Console → Table → Scopes and Permissions → App User role → 为已认证用户需要写入的表勾选 Insert/Update/Delete。
  • App Administrator 默认拥有所有权限。 绝不要将 App Administrator 角色分配给普通终端用户 — 该角色可完整读取、写入和删除所有表中的数据。

触发词

在涉及以下内容时使用此技能：“Data Store”、“ZCQL”、“catalyst table”、“create table”、“query data”、executeZCQLQuery、“table permissions”、“App User permissions”、“ROWID”、“CREATEDTIME”、“Data Store CRUD”、“JOIN in ZCQL”、“pagination ZCQL”、“data store column types”、“insert row”、“update row”、“delete row”或“relational data on Catalyst”。

参考资料

参考资料在查询涉及以下内容时加载……
references/datastore-basics.mdCRUD、ZCQL 查询、结果解包、分页、列类型、App User 权限设置、CREATEDTIME 时区注意事项、表情符号限制

评论

支持 Markdown