SuperAPI AI 工具集

kuroco-admin-api

编程与开发

查看项目

更新于 10-15 21:33

技能介绍

用途:在无法配置 MCP 连接的环境中,用 Bash 调用 kuroco-admin CLI 操作 Kuroco 管理 API(admin_api),完成 API 模型与方法探索、schema 获取及内容创建、成员注册等管理操作。

主要能力:admin_api 有五种模式——whoami 返回 member_id、name、group_ids;discover 探索可用模块与控制器;schema 获取控制器/服务的请求响应结构;advise 用自然语言描述需求,由 AI 给出应调用的 API 与步骤;execute 执行 GET/POST,可用 --columns 选择返回列。

使用方式:安装需 Bun 运行时,且 kuroco-admin CLI 已构建或加入 PATH:bun build --compile kuroco-admin.ts --outfile kuroco-admin,然后 cp kuroco-admin /usr/local/bin/。登录用 kuroco-admin login --url https://example.g.kuroco-mng.app,会话 Cookie 持久化到 ~/.kuroco-admin/cookies.txt。典型流程:kuroco-admin whoami --json 检查认证;用 advise 或 discover 了解结构;写入前用 help 获取 schema;再执行 exec,如 kuroco-admin exec topics/topics_list --param "topics_group_id[]=1" --columns topics_id,subject --json。写入用 --MODE INSERT/UPDATE/DELETE 配合 --data,可先 --dry-run 预览。

适用场景:CLI 或 Bash 脚本中的 Kuroco 管理操作、自动化与批处理。

限制:所有操作以登录用户权限执行;AI agent 调用应始终加 --json,GET 数组参数需 [] 后缀;须使用 mt/ct 形式而非 model/method;写入前应获取 schema 并经用户确认;exit code 2 表示认证失效需重新登录;Cookie 与 --verbose 输出不得泄露;本技能不适用于前端 API 操作。