用途:通过 Strapi MCP 将一批 URL 对应的记录从旧实例 production-old(Strapi v4)批量迁移到目标实例 production(Strapi v5)。适用于粘贴一批 URL 后无需进一步交互、期望一次性完成迁移的场景。
主要能力:按全自动方式运行,不询问用户也不请求审批,默认 mode=replace(清空并重建目标动态区)、publish=true、media_policy=reuse-existing。根据 URL 路径前缀判定内容类型;旧 use-case 与 universal 记录会合并进新的 page 集合,page 按 fullPath(而非 slug)查找;无法匹配的 URL 跳过并记入 unmatchedUrls。输入参数包括 urls(必填)、source_server、target_server、mode、publish、media_policy。
使用方式:先调用 mcp__strapi-local__strapi_list_servers() 校验 MCP 与服务端;解析 URL 并按内容类型分组;读取本地目标 schema 并检查各组件必需字段;发现目标分类类关系并构建 name→documentId 映射;按 slug 或 fullPath 查找目标 documentId,未找到时先创建草稿壳;随后按内置映射表(components-cheatsheet.csv 为准)将旧 slice/根字段映射为 v5 组件;最后发布并输出报告。
限制与注意:仅当用户明确写出 interactive 或 ask me 时才可交互询问。迁移前须判断目标是否已有 v5 原生或精选内容且是否存在可定位的 v4 源记录;无 v4 源的页面应改为 validate-only,不可清空覆盖(如 features 页面、部分列表/索引页)。查询时不要使用 populate: { content: { fields: [...] } }(在 Strapi Cloud 会 500),改用 populate: { content: true } 或省略。媒体上传成本高,某些必需媒体字段的 slice 默认倾向跳过。若缺少 source_server 或 target_server 则报告并停止,不提供安装 MCP。