t1yOS MCP Tools 列表

  1. Home
  2. Mcp
  3. Tools
  4. t1yOS MCP Tools 列表

t1yOS MCP Tools 列表

本文档列出 t1yOS 平台当前版本所有可用的 MCP 工具，按功能模块分组，说明每个工具的名称、功能、参数及读写属性。

数据库操作

集合管理

工具名 描述 参数 只读/破坏
db_list_collections 列出当前应用下所有云数据库中的集合名称 无 只读
db_create_collection 新建集合（插入文档时若集合不存在则自动创建） collection (string, 必填) – 要创建的集合名称 非破坏
db_copy_collection 通过 $out 聚合复制集合到新集合 sourceCollection (string, 必填) – 源集合名称targetCollection (string, 必填) – 目标集合名称 非破坏
db_clear_collection 清空指定集合中的全部文档（保留集合本身） collection (string, 必填) – 要清空的集合名称 破坏性
db_drop_collection 彻底删除整个集合（含所有文档和索引），不可恢复 collection (string, 必填) – 要删除的集合名称 破坏性

文档插入

工具名 描述 参数 只读/破坏
db_insert_one 向指定集合插入一条文档，自动写入 createdAt / updatedAt collection (string, 必填) – 目标集合名称document (object, 必填) – 要插入的 JSON 文档 非破坏
db_insert_many 向指定集合批量插入多条文档，自动写入时间戳 collection (string, 必填) – 目标集合名称documents (array of objects, 必填) – 文档数组 非破坏

文档删除

工具名 描述 参数 只读/破坏
db_delete_one_by_objectId 通过 ObjectId 删除单条文档 collection (string, 必填) – 集合名称object_id (string, 必填) – 24 位十六进制 ObjectId 破坏性
db_delete_one 按 filter 条件删除第一条匹配的文档 collection (string, 必填) – 集合名称filter (object, 必填) – 匹配条件 破坏性
db_delete_many 按 filter 条件批量删除所有匹配的文档 collection (string, 必填) – 集合名称filter (object, 必填) – 匹配条件（{} 表示删除全部，极高危） 破坏性

文档更新

工具名 描述 参数 只读/破坏
db_update_one_by_objectId 通过 ObjectId 更新单条文档，自动更新 updatedAt collection (string, 必填) – 集合名称object_id (string, 必填) – 24 位 ObjectIdupdate (object, 必填) – 更新内容（如 {"$set":{...}}） 非破坏
db_update_one 按 filter 条件更新第一条匹配的文档 collection (string, 必填) – 集合名称filter (object, 必填) – 匹配条件update (object, 必填) – 更新操作符 非破坏
db_update_many 按 filter 条件批量更新所有匹配的文档 collection (string, 必填) – 集合名称filter (object, 必填) – 匹配条件（{} 高危）update (object, 必填) – 更新操作符 破坏性

文档查询

工具名 描述 参数 只读/破坏
db_find_one_by_objectId 通过 ObjectId 查询单条文档 collection (string, 必填) – 集合名称object_id (string, 必填) – 24 位 ObjectId 只读
db_find_one 按 filter 条件查询第一条匹配的文档 collection (string, 必填) – 集合名称filter (object, 可选，默认 {}) – 查询条件 只读
db_find 分页查询集合文档，支持过滤和排序 collection (string, 必填) – 集合名称filter (object, 可选，默认 {}) – 查询条件sort (object, 可选，默认 {"createdAt":-1}) – 排序规则page (int64, 可选，默认 1) – 页码size (int64, 可选，默认 10，范围 1-100) – 每页数量 只读
db_count 统计符合 filter 条件的文档数量 collection (string, 必填) – 集合名称filter (object, 可选，默认 {}) – 查询条件 只读
db_distinct 获取指定字段的去重值列表 collection (string, 必填) – 集合名称field (string, 必填) – 要去重的字段名filter (object, 可选，默认 {}) – 查询条件 只读
db_search 按关键词跨字段全文搜索（ObjectId 精确匹配 + 正则模糊匹配），分页返回 collection (string, 必填) – 集合名称keyword (string, 必填) – 搜索关键词searchFields (array of strings, 必填) – 要搜索的字段列表page (int64, 可选，默认 1) – 页码size (int64, 可选，默认 10，范围 1-100) – 每页数量 只读

聚合

工具名 描述 参数 只读/破坏
db_aggregate 执行 MongoDB 聚合管道（支持 $match/$group/$sort/$lookup/$project 等所有阶段） collection (string, 必填) – 集合名称pipeline (array of objects, 必填) – 聚合管道阶段数组 只读

索引管理

索引功能需升级至专业版。

工具名 描述 参数 只读/破坏
db_list_indexes 列出指定集合的所有索引（不含 _id_） collection (string, 必填) – 集合名称 只读
db_create_index 为集合创建索引（支持普通、唯一、稀疏、TTL） collection (string, 必填) – 集合名称fields (array of {key:string, value:int}, 必填) – 索引字段unique (bool, 可选，默认 false) – 是否唯一sparse (bool, 可选，默认 false) – 是否稀疏name (string, 可选) – 索引名称ttl (bool, 可选，默认 false) – 是否 TTL 索引expireAfterSeconds (int32, 可选) – TTL 过期秒数 非破坏
db_drop_index 删除指定集合的某个索引 collection (string, 必填) – 集合名称indexName (string, 必填) – 要删除的索引名称 破坏性

权限管理

权限仅对 RESTful API 生效，云函数与 MCP 工具可直接操作。

工具名 描述 参数 只读/破坏
db_get_permission 获取指定集合的 CRUD 权限设置 collection (string, 必填) – 集合名称 只读
db_create_permission 创建/更新集合的 CRUD 权限（Upsert） collection (string, 必填) – 集合名称permission (object {c,r,u,d: bool}, 必填) – 权限对象 非破坏
db_update_permission 更新指定集合的 CRUD 权限 同上 非破坏
db_delete_permission 删除集合的 CRUD 权限（恢复默认全禁止） collection (string, 必填) – 集合名称 破坏性

环境变量

工具名 描述 参数 只读/破坏
env_list 列出当前应用的所有环境变量 无 只读
env_get 获取指定 Key 的环境变量值 key (string, 必填) – 环境变量名称 只读
env_create 添加新的环境变量 key (string, 必填，长度 1-255) – 变量名value (string, 必填，长度 1-3072) – 变量值 非破坏
env_update 编辑环境变量的值 key (string, 必填，长度 1-255) – 变量名value (string, 必填，长度 1-3072) – 新值 非破坏
env_delete 删除指定 Key 的环境变量 key (string, 必填，长度 1-255) – 变量名 破坏性

文件管理

工具名 描述 参数 只读/破坏
file_list 列出指定目录下的文件和子目录 path (string, 可选，默认 /) – 目录路径 只读
file_mkdir 创建文件夹（自动创建父级目录） path (string, 必填) – 以 / 开头的目录路径 非破坏
file_create 创建空文件（如已存在则失败） path (string, 必填) – 文件路径 非破坏
file_rename 重命名或移动文件/文件夹 oldPath (string, 必填) – 源路径newPath (string, 必填) – 目标路径 破坏性
file_delete 删除文件或文件夹（不可恢复） path (string, 必填) – 要删除的路径 破坏性
file_write 写入（覆盖）文件内容，文件不存在时自动创建 path (string, 必填) – 文件路径content (string, 必填) – 要写入的文本内容 非破坏
file_read 读取文件内容，支持 UTF-8 / GBK / GB18030 编码 path (string, 必填) – 文件路径encoding (string, 可选，默认 utf-8) – 文件编码 只读

文件重命名、删除、写入涉及 .functions 目录时会触发云函数重新编译。

云函数

工具名 描述 参数 只读/破坏
function_list 列出当前应用所有云函数的状态（会先执行全量重编译） 无 可写（会触发编译）
function_get_code 获取指定云函数的源代码 name (string, 必填) – 函数名（不带 .jsc 后缀） 只读
function_create_from_example 使用内置示例代码创建云函数 name (string, 必填) – 新函数名 非破坏
function_create 通过代码创建云函数（建议先读取运行时规范） name (string, 必填) – 函数名code (string, 必填) – 完整的函数代码 非破坏
function_delete 删除云函数（会同时清理关联的定时任务） name (string, 必填) – 函数名 破坏性
function_update 更新云函数代码 name (string, 必填) – 函数名code (string, 必填) – 新代码内容 非破坏
function_run 执行云函数并获取结果（内部 GET 请求） path (string, 必填) – 云函数路径，如 /index.jsc 可写（执行）
function_rebuild_all 重新编译当前应用的全部云函数 无 非破坏
function_get_log 获取云函数运行日志（末尾约 20KB） 无 只读
function_clear_log 清空当前应用的全部云函数运行日志 无 破坏性

应用设置

工具名 描述 参数 只读/破坏
app_info 获取当前应用的详细信息（AppID、密钥、域名、计划等） 无 只读
app_bind_domain 绑定自定义域名（需 CNAME 至 myapp.t1y.net，专业版功能） domain (string, 必填，长度 1-255) – 域名 非破坏
app_enable_safe_mode 开启安全模式（请求/响应动态加密） 无 非破坏
app_disable_safe_mode 关闭安全模式 无 非破坏
app_enable_auto_renew 开启自动续费 无 非破坏
app_disable_auto_renew 关闭自动续费 无 非破坏
app_renew 续费当前应用（按月从余额扣款） duration (int, 必填，1-120) – 续费月数 破坏性（扣款）
app_set_meta 设置应用的自定义 Meta 元数据（最大 1MB，须为有效 JSON） meta (string, 必填，最大 1MB) – JSON 字符串 非破坏
app_get_meta 获取当前应用的自定义 Meta 元数据 无 只读

定时任务

定时任务功能需升级至专业版。

工具名 描述 参数 只读/破坏
task_list 列出当前应用的所有定时任务 无 只读
task_create 创建新的定时任务 name (string, 必填，长度 1-64) – 任务名称program (string, 必填) – 云函数名（以 / 开头，不带后缀）cron (string, 必填，长度 1-32) – Cron 表达式 非破坏
task_delete 删除指定定时任务 taskId (uint, 必填) – 任务 ID 破坏性
task_start 启动已停止的定时任务 taskId (uint, 必填) – 任务 ID 非破坏
task_stop 停止运行中的定时任务 taskId (uint, 必填) – 任务 ID 非破坏

说明：所有数据库操作的“权限仅对 RESTful API 生效”意味着 MCP 工具与云函数均不受集合级 CRUD 权限限制；对云函数文件的写入、删除等操作会自动触发重编译。