Skip to main content
Glama

Spine JSON MCP

项目进展(2026-10-22):当前主线与阻塞。工程/Host 新增 10 个入口,另增 2 个只读入口,合计 101 个工具,源码 0.2.0。工程模型、协议勘察、观察 Host、MCP 快照桥接与 C1 隔离事务流程已实现;三张真实 player 合成 region 基线通过原像素门限。真实 npc1 的无参考站姿已完成单手编辑、撤销、官方 player 截图、逐项视觉审查、授权保存和重开复验,原资源字节未变。整单尚未验收完成:两周稳定观察、公开写入发布与 C2 扩展仍待完成。源码、131 项回归、90 个合成样本的端到端 P95 82.35ms 及覆盖边界见 实施记录。npc1 攻击准备姿态仍有 7 项必要失败,旧 exe 未更新。

源码构建后可用 npm run host 启动独立观察页。MCP 可调用 spine_create_project 显式预演工程初始化,再用 spine_host_open 打开已绑定文档;未启动 Host 时可使用镜像。初始化不覆盖现有 manifest,不修改角色资源。默认查询不隐式求解,需重算时显式调用 spine_solve_pose 或设置 recheck:true。

C1 附着审查已接通:spine_review_pose 使用当前完整版本和 player manifest,默认只预演;批准需数值、适用参考/阶段/关系及七项独立理由。保存保留批准或退回记录,新修订可独立复验;证据事后变化阻止提交。该闭环已在真实角色的隔离站姿修订中验证,生产公开写入仍关闭。

长任务遵循 200ms 通知节流、末条必发、无 token 静默。按用户确认的 L1/L2 v1.4,短任务验首末,至少 1 秒的 60 次迭代验至少六条。局部修正已取消时零评估,进度回调取消后不继续下一轮;实际 MCP 渲染取消后约 31ms 停止、34ms 释放锁,服务继续响应。已完成事务不会因取消伪装成回滚。

WinForms 源码已加入“动画预览 / Host 工作台”页签。Host 页从同一工作区发现并核对已有服务,不读取控制凭据或接管写入;切走/最小化会卸载页面,恢复后重新读取当前状态。真实 WebView2 的 23 项隔离自检已通过,旧便携发布包尚未更新。构建/运行与自检见 桌面说明。

架构研究:成熟 MCP 对标与 Host 架构评估,对照 3D 编辑器 MCP 与文件/运行时工作流,评估 AI Spine 工作台的工程模型、操作能力和持续反馈闭环。

最新实际 MCP 验证:npc1 姿态实例复验。attack_pose_reviewed 已写入,但用户指出初始帧明显不匹配;此前 Agent 视觉批准已撤销,当前验收不通过。已有数值/runtime 通过与 GIF 产物不代表参考姿态匹配。

新增参考先行的 Pose to Pose 流程:参考关节标注和连线审查 → 标准站姿 → 目标关键姿态上下对比 → 补间候选/GIF 审查 → 安全提交。详见 姿态校准与视觉审查。静态图片和动画 WebP 可通过现有参考拆帧接口处理。新增源码已构建,已启动的旧 MCP 服务需重新加载;旧便携包不会自动更新。

浏览器 PMA 选项会按 atlas 页面 Alpha 格式生成配套预览纹理,不只切换混合公式;原图不修改。直通 Alpha 的 NPC1 贴图可直接勾选 PMA,状态栏会显示实际转换页数。

本轮细节工具实测与 idle runtime 优化见 细节工具实测验收。曲线拟合可传 atlasPath 回读验证实际误差;useCurves:true 输出三次贝塞尔,默认 false 使用线性简化。

这是一个 TypeScript MCP 服务器,用于受控地读取、校验和修改 Spine 导出的 JSON 文件。第一版的写入范围为动画时间线。

安装与构建

Windows 便携 exe 发布:powershell -ExecutionPolicy Bypass -File scripts/publish-observer.ps1。输出在 releases/SpineMCP-win-x64-时间戳/,包含自带 .NET 的 exe、Node 与生产依赖;运行仍需 WebView2。双击 exe 选择项目,自动启动本机预览服务,关闭窗口停止它启动的服务。保留整个发布目录,移动目录后重新配置 Agent。

npm install
npm run build
npm test

Related MCP server: spine-anim-mcp

运行

npm run build
node dist/server.js

服务器使用 MCP stdio 传输。默认情况下,所有文件工具只能访问当前工作目录内的文件。可以通过 SPINE_MCP_WORKSPACE 指定工作区根目录。

通用 Mesh 布点

构建后可用 npm run mesh -- plan 为透明 PNG 生成点位和布点图,用 npm run mesh -- candidate 批量生成经过 Spine 4.3.26 回读的加权 Mesh 候选工程。

MCP 提供同一实现的 spine_mesh_plan 和 spine_mesh_build_candidate,使用已选工作区,并将产物写入独立的新目录。候选工具从服务启动环境的 SPINE_MCP_MESH_EDITOR 读取本机编辑器路径。布点工具直接读取 PNG。服务配置、调用示例及验收方法见 Mesh 布点工具。

浏览器预览

项目提供一个独立浏览器预览层,用本地安装的官方 Spine Web runtime 加载工作区内的 JSON、atlas 和贴图资源。预览层只负责显示动画,不负责写入 JSON。

npm run build
npm run preview

默认访问:

http://127.0.0.1:5177

当前预览默认使用 example-json/skeleton-4.1.json、preview/xiaoren.atlas 和 preview/xiaoren.png。预览系统说明见 docs/浏览器预览系统.md。

WinForms 观察平台

项目提供一个最小 WinForms 观察壳,路径为 apps/winforms-observer。它读取 /api/session,展示 Agent 设置的当前上下文和操作日志,会话变化时调用 /api/validation-pipeline 展示验证结果,通过 /api/agent-connection 展示 Codex、Claude Code、opencode 等 Agent 的连接状态,并用 WebView2 嵌入预览 URL。

推荐用一键脚本启动,它会自动构建、选择空闲端口、启动预览服务并打开 WinForms:

npm run observer

脚本会写入运行态状态文件 .spine-mcp/observer-runtime.json,记录本次启动的 preview server 端口、URL、PID、WinForms PID 和日志路径。该文件只用于观察平台运行管理,不写 Spine JSON。

WinForms 会读取这个运行态状态文件,在左侧显示 preview server URL/PID、WinForms PID、启动时间、日志路径和停止命令,并提供“复制停止命令”“打开日志”两个辅助按钮。

停止由脚本启动的观察平台:

npm run observer:stop

停止前预览将要停止的进程:

powershell -ExecutionPolicy Bypass -File scripts/stop-observer.ps1 -DryRun

也可以直接运行:

powershell -ExecutionPolicy Bypass -File scripts/start-observer.ps1

如果只想检查端口和路径,不启动进程:

powershell -ExecutionPolicy Bypass -File scripts/start-observer.ps1 -CheckOnly
dotnet run --project apps/winforms-observer/SpineMcp.WinFormsObserver.csproj

WinForms 只观察和预览,不直接编辑 JSON。设计说明见 docs/WinForms观察平台设计.md。

在 Codex 中使用

本项目可作为 Codex MCP server 使用。配置示例:

[mcp_servers.spine_json_mcp]
command = 'C:\Program Files\nodejs\node.exe'
args = ['D:\AI_cc\spine-mcp\dist\server.js']
startup_timeout_sec = 30

[mcp_servers.spine_json_mcp.env]
SPINE_MCP_WORKSPACE = 'D:\AI_cc\spine-mcp'

修改 Codex 配置后,需要重启 Codex 或开启新会话,让 MCP 工具列表重新加载。加载成功后,可以让 Codex 调用 spine_get_document_summary、spine_get_animations、spine_validate_json 等工具。

连接成功后,建议让 Agent 调用一次握手工具:

{
  "tool": "spine_agent_ping",
  "arguments": {
    "clientType": "codex",
    "agentName": "Codex"
  }
}

WinForms 的“一键配置”支持 Codex、Claude Code、opencode;Codex 默认推荐用户级,其他客户端默认项目级。确认路径后自动备份与写入。Codex 桌面需完全退出并重开;项目配置还需项目信任/批准。绿灯由定期 MCP 协议 ping 判定,黄灯表示等待连接/响应,红灯表示离线/过期;历史握手不会维持绿灯。详见 Agent 一键配置与实时连接。

完整 MCP 操作列表见 docs/MCP操作清单.md。

官方 JSON 规范审查说明见 docs/官方JSON规范审查.md。自然语言验证用例见 docs/自然语言验证用例.md。标准演示用例见 docs/标准演示用例.md。安全提交流程见 docs/安全提交流程.md。浏览器预览说明见 docs/浏览器预览系统.md。WinForms 观察平台设计见 docs/WinForms观察平台设计.md。

如果要从 Agent 接入开始走一遍最短闭环,优先参考 docs/最小使用流程.md。该文档按顺序记录了 Codex 连接、Agent 握手、启动 WinForms、dryRun、真实写入和验证流水线。

V1 范围

  • 读取 Spine JSON 摘要、骨骼层级、插槽、皮肤、动画列表、动画时间线和关键帧表格。

  • 校验 Spine JSON 结构、引用关系、附件时间线、绘制顺序偏移和关键帧排序。

  • 按 Spine 官方 JSON 导出格式和 4.1.24 样本适配规则审查当前可写 timeline 子集。

  • 管理动画:创建、复制、删除动画。

  • 批量编辑动画:平移关键帧、缩放时间、删除范围、复制片段、批量写入姿态、一次性写入多姿态动画序列、偏移骨骼数值、闭合循环。

  • 从自然语言制作新动画时,优先使用 spine_apply_pose_sequence 把多个姿态时间点放进一次事务,减少多次写入、多次备份和多次审查调用。

  • 只写入动画时间线数据:

    • 骨骼 rotate、translate、scale、shear

    • 插槽 attachment

    • 动画 drawOrder / draworder

  • 写入工具默认 dryRun: true,只返回差异,不修改文件。

  • 写入工具返回去重后的 affectedPaths、完整 diff、中文 summary、diff 白名单结果和官方规范审查结果,便于 Agent 判断修改范围和下一步操作。

  • 提交写入时会在 backups/ 中生成备份。

  • 可通过 spine_list_backups 查看备份,通过 spine_restore_backup 执行带 dryRun、confirm、expectedHash 和二次备份保护的恢复流程。

  • 浏览器预览层通过官方 Spine Web runtime 动态加载修改后的 JSON;runtime 的 major.minor 必须匹配 skeleton.spine。

  • 预览辅助工具可以检查资源并生成带参数的浏览器预览 URL,但不写入 JSON。

  • spine_runtime_validate 可以用本地官方 spine-core@4.1.56 读取 JSON、atlas 和附件数据,确认文件不只是结构校验通过,也能被当前 4.1 runtime 加载。

  • spine_run_validation_pipeline 可以在真实写入后一次性执行结构校验、官方 runtime 加载验证和预览 URL 生成,作为推荐复查入口。

  • spine_preview_set_session / spine_preview_get_session / spine_preview_clear_session 提供 Agent 驱动的预览会话状态,供浏览器预览层和未来 WinForms 观察平台同步当前 JSON、atlas、动画和操作说明。

  • spine_agent_ping / spine_agent_get_connection_status 提供 Agent 连接握手和配置片段查询,供 WinForms 连接向导显示红/黄/绿状态。

  • V1 有意不修改 setup pose、bones、slots、skins、mesh/deform、constraints 和 events。

版本策略

写入工具接受 skeleton.spine 声明的任意完整版本号,例如 4.3.26 或 4.4.01-beta。版本缺失、格式无效或仅有主次版本时拒绝写入。写入仍需通过当前 timeline 字段审查、diff 白名单和结构引用校验。spine_get_document_summary 的 writable 表示版本声明通过,timelineReferenceVersion 表示编写可写子集时采用的样本版本。需要 runtime 验证的流程仍要求匹配的 runtime。

项目规则

项目规则记录在 AGENTS.md。后续所有新增文档、注释性说明、工具说明和面向 Agent 的描述都应优先使用中文。

动画生成工作流

项目现在提供角色 mapping、角色无关动作文件、动作重定向、曲线压缩和批处理工具。示例文件位于 mappings/、motions/、jobs/,详细流程见 docs/动画生成工作流.md。

新增 MCP 工具:spine_inspect_character、spine_create_mapping_draft、spine_calibrate_mapping、spine_confirm_mapping、spine_validate_mapping、spine_extract_motion、spine_validate_motion、spine_retarget_motion、spine_validate_motion_result、spine_fit_animation_curves、spine_batch_retarget。生成、校准和曲线工具默认 dryRun: true;v2 真实写入还必须经过 mapping 确认、校准报告、reviewToken、hash、备份、diff 白名单、JSON 规范和官方 runtime 门禁。

当前升级已通过 npm run build 和 npm test。示例 walk、idle 和 run 可经过 mapping、IK、脚底/手腕约束、曲线压缩、JSON 规范校验和 @esotericsoftware/spine-core runtime 验证。新增离线预览工具会生成固定相机 PNG 贴图帧、contact sheet 和 preview manifest;GIF 使用本地编码器生成,参考 GIF 可拆帧、分析时间与重复帧。工作区支持 projectId 登记,同时兼容 SPINE_MCP_WORKSPACE。

离线视觉验证与项目工作区升级

新增离线 PNG 帧、联系图、GIF、参考 GIF 分析、对比报告及 projectId/MCP Roots 支持。默认重定向生成数值报告和联系图;Agent 查看后提交。详细工具、参数、局部调整、缓存/锁和已知验证边界见 离线视觉验证与工作区。

关节与切片驱动姿态

新增 visualRig 校准/确认、参考单姿态适配及实际骨架比较四个 MCP 工具。参考任务缺少有效绑定、比较报告或逐阶段依据时不能确认;候选动画关键时间再次通过官方 runtime 回读复核。详见 关节切片驱动姿态流程。NPC1 旧准备姿态已被程序判错,新准备候选仍有冲突,尚未完成整段攻击和编辑器验收。

完整动画诊断实例(不批准、不提交)

spine_retarget_motion 新增 diagnosticPreview:true,仅支持 dryRun。用户要求观察整段失败候选时,可在保留未确认姿态和失败报告的前提下生成完整诊断动画:候选 JSON、实际关键时间关系比较、固定相机上下姿态图和目标原速 GIF。通过 spine_render_animation_comparison 生成上下同步 GIF。

诊断结果始终为 ok:false、diagnosticOnly:true、readyToCommit:false,分别返回 numericOk、poseGate、keyGraphs 和 previewIssues,不产生 reviewToken,不修改原角色。它是观察失败的独立出口,不能替代正式姿态/动画审查或用于提交。diagnosticPreview:true,dryRun:false 必须拒绝;渲染失败仍保留候选与错误。

实际验证脚本:scripts/acceptance-animation-diagnostic.mjs。先执行 references,Agent 查看参考连线图并填写逐阶段参考判断后执行 animate。脚本通过实际 MCP stdio 求解和渲染,仅创建工作流草稿,不自动批准任何目标姿态或完整动画。环境变量 ANIMATION_DIAGNOSTIC_DIR 可指定已有实例相对目录。

中文负例:把手目标设到骨骼不可达范围,再请求完整动画诊断。预期得到失败报告及 GIF、原 JSON 哈希未变、无提交令牌;请求真实写入仍应拒绝。不要把 GIF 生成成功描述为动画匹配通过。

解剖持杖手、身体视角及切片遮挡检查

参考 observation.actionSemantics 支持 version:1 / weaponHand:left|right / identityStatus:confirmed / anatomicalBasis / bodyView / bodyViewBasis / occlusion。身体视角可为 frontThreeQuarter、side、backThreeQuarter,参考有不确定性时可用 sideOrBackThreeQuarter。遮挡项保存 {front,back,basis},语义部位可为 body 或已有肢体线段编号(如 rightArm.1)。缺少必要遮挡关系返回无法验证,不默认为通过。

spine_calibrate_visual_rig 增加 anatomicalSides 与 viewProfiles,均绑定确认指纹。解剖左右映射保持跨阶段稳定;视角配置保存实际附件状态、躯干插槽和看图校准依据。姿态 frame.action.driver 明确实际目标驱动手(如 rightHand),骨架比较独立输出 action.weaponHand、action.bodyView、action.occlusion.*。身体视角从 runtime 实际附件配置匹配已确认 profile;未经校准不能只传一个“背面”标签通过。遮挡用 runtime 绘制顺序回读。Agent 判断仍参与视角配置校准,这不是自动像素识别或数学上的视觉保证。

frame.presentation 支持受控 attachments 和完整 drawOrder 插槽排列,沿用 spine_adjust_pose、spine_solve_pose 和 v2 motion。显示状态在阶段边界离散切换,导出为已有 attachment/drawOrder 时间线;不改 setup、绑定、mesh、atlas 或 PNG。现有后发、面部显隐及背包层序可构造转身诊断候选,但不代表有完整三维转身模型。需要逐姿态查看轮廓并重新校准,不能自动批准隐藏五官后的身体视角。

中文验证:右手参考对应左手驱动必须失败;正面配置不能覆盖侧背参考;缺失视角/遮挡信息必须无法验证;同一附件状态不能标记成两种不同视角;遮挡层序反转必须失败。切片状态修改使配置匹配和旧审查失效。官方 runtime 回读 attachment/drawOrder 的阶段切换必须与单姿态一致。

准备姿态适配与有界修正(2026-10-10)

新增动作级身份校验、肩髋躯干轴和最多60次的确定性局部修正。见 准备姿态适配与修正闭环。本轮 npc1 必要关系和数值通过,视觉审查退回;未批准完整攻击。

MCP 协议补充:现已提供只读 resources 与三个流程 prompts;spine_get_workspace_tree 可有界勘察目录,spine_recheck_pose 显式重算。roots 不覆盖用户选择,摘要默认零求解;长任务有进度和取消,缓存仅复用不可变模板,批准门禁始终严格复核。需重启 MCP 进程加载新构建。

源码版本为 0.2.0:spine_get_pose_state 默认返回零求解摘要,详细关节需显式 spine_recheck_pose;未知工具参数及未知语义 frame/patch 字段会被拒绝。旧客户端应先刷新 tools/list。工程切换会等待旧 Host 关闭、发现文件退役及写入锁释放;未确认交接时保持冻结。新构建不自动重启用户正在使用的 MCP,也不改全局配置。

Available Tools

36 tools
spine_agent_get_connection_statusA

读取 Agent 连接状态、最近握手、项目规则检测和 Codex/Claude Code/opencode 配置片段。只读,不写 Spine JSON。

Inputs: clientType.

spine_agent_pingA

Agent 连接握手工具。Agent 成功连接 MCP 后调用它,WinForms 连接向导会据此显示绿色连接状态。只写运行态握手文件,不写 Spine JSON。

Inputs: agentName, clientType, clientVersion, note.

spine_apply_pose_keyframesC

在同一时间点批量设置多个骨骼和插槽的姿态关键帧。

Inputs: filePath (required), animation (required), time (required), bones, +5 more.

spine_apply_pose_sequenceC

一次性创建或覆盖动画,并批量写入多个姿态时间点;适合减少多次写入、备份和审查调用。

Inputs: filePath (required), animation (required), poses (required), overwrite, +5 more.

spine_clone_animationB

复制一个已有动画,作为后续编辑模板。默认不覆盖目标动画。

Inputs: filePath (required), sourceAnimation (required), targetAnimation (required), overwrite, +3 more.

spine_copy_keyframe_rangeC

把一个动画片段复制到另一个动画或同一动画的指定时间点。

Inputs: filePath (required), sourceAnimation (required), targetAnimation (required), sourceRange (required), +5 more.

spine_create_animationC

新建空动画。默认不覆盖已有动画。

Inputs: filePath (required), animation (required), overwrite, dryRun, +2 more.

spine_delete_animationB

删除动画。高风险操作,必须显式传 confirm: true。

Inputs: filePath (required), animation (required), confirm (required), dryRun, +2 more.

spine_delete_keyframe_rangeB

删除某段时间范围内的关键帧,可按骨骼、插槽或绘制顺序过滤。

Inputs: filePath (required), animation (required), range (required), targets, +3 more.

spine_get_animationsB

返回动画名称、估算时长和时间线类型统计。

Inputs: filePath (required).

spine_get_animation_sheetC

返回适合 Agent 编辑的关键帧表格,包含目标、时间线、时间、值、曲线和 JSON path。

Inputs: filePath (required), animation (required), targetType, targetName.

spine_get_animation_timelinesC

返回指定动画的原始时间线和规范化摘要,可按目标类型和名称过滤。

Inputs: filePath (required), animation (required), targetType, targetName.

spine_get_document_summaryB

返回 Spine JSON 版本、文件哈希、顶层字段、数量统计,以及 V1 是否允许写入。

Inputs: filePath (required).

spine_get_official_spec_summaryA

返回当前 MCP 内置的 Spine 官方 JSON 规范审查摘要、可写 timeline 规则和 4.1.24 字段适配说明。

Inputs: no named parameters.

spine_get_skeleton_hierarchyB

返回骨骼树;可选返回 setup pose 的局部变换。

Inputs: filePath (required), includeSetupPose.

spine_get_skinsB

返回皮肤名称和附件摘要。

Inputs: filePath (required), includeAttachments.

spine_get_slotsA

返回插槽绘制顺序、绑定骨骼、默认附件和显示属性。

Inputs: filePath (required).

spine_list_backupsA

列出 backups/ 中的 Spine JSON 备份,可按目标 filePath 过滤,并可校验备份 JSON 是否可用。只读,不写入 JSON。

Inputs: filePath, includeValidation.

spine_make_loopB

把 sourceTime 的已有关键帧复制到 targetTime,用于让循环动画首尾闭合。

Inputs: filePath (required), animation (required), sourceTime (required), targetTime (required), +4 more.

spine_offset_bone_timeline_valuesC

批量调整骨骼时间线数值,可增加偏移或按比例缩放。

Inputs: filePath (required), animation (required), bones (required), timeline (required), +6 more.

spine_preview_check_assetsA

检查预览所需的 JSON、atlas 和 atlas 引用贴图是否存在,并确认目标动画是否存在。只读,不写入 JSON。

Inputs: filePath, atlasPath, animation.

spine_preview_clear_sessionA

清空当前预览会话状态,恢复默认 JSON、atlas 和动画。只写会话状态,不写 Spine JSON。

Inputs: no named parameters.

spine_preview_get_configA

返回浏览器预览层默认配置、官方 runtime 版本和 URL 参数说明。只读,不写入 JSON。

Inputs: baseUrl.

spine_preview_get_sessionA

读取当前 Agent 驱动的预览会话状态,并返回对应预览 URL。只读,不写入 JSON。

Inputs: baseUrl.

spine_preview_get_urlA

生成可直接打开的浏览器预览 URL,支持指定 JSON、atlas、动画、皮肤、PMA、Mipmaps 和自动载入。只读,不写入 JSON。

Inputs: filePath, atlasPath, animation, skin, +5 more.

spine_preview_set_sessionA

设置 Agent 驱动的预览会话状态,让 WinForms 或浏览器预览层自动知道当前 JSON、atlas、动画和操作说明。只写会话状态,不写 Spine JSON。

Inputs: filePath, atlasPath, animation, skin, +6 more.

spine_remove_keyframeC

按时间从骨骼、插槽或绘制顺序时间线中删除关键帧。

Inputs: filePath (required), animation (required), targetType (required), timeline (required), +5 more.

spine_restore_backupA

将 backups/ 中的指定备份恢复到目标 JSON 文件。高风险操作,必须 confirm:true;默认 dryRun:true;真实恢复前会先备份当前目标文件。

Inputs: backupPath (required), targetFilePath (required), confirm (required), dryRun, +1 more.

spine_runtime_validateA

使用官方 spine-core runtime 读取 JSON、atlas 和附件数据,验证资源是否能被当前 4.1 runtime 加载。只读,不写入 JSON。

Inputs: filePath, atlasPath, animation, skin, +1 more.

spine_run_validation_pipelineA

执行写入后的推荐只读验证流程:结构校验、官方 runtime 加载验证和预览 URL 生成。不写入 JSON。

Inputs: filePath (required), atlasPath, animation, skin, +6 more.

spine_scale_keyframe_timesC

以 originTime 为原点压缩或拉伸指定关键帧的时间。

Inputs: filePath (required), animation (required), originTime (required), scale (required), +5 more.

spine_set_bone_keyframeC

为已有动画中的已有骨骼插入或更新 rotate/translate/scale/shear 关键帧。

Inputs: filePath (required), animation (required), bone (required), timeline (required), +6 more.

spine_set_draw_order_keyframeC

使用官方 draw order offsets 结构插入或更新绘制顺序关键帧。

Inputs: filePath (required), animation (required), time (required), offsets (required), +3 more.

spine_set_slot_attachment_keyframeB

插入或更新插槽附件关键帧。attachmentName 为 null 表示隐藏附件。

Inputs: filePath (required), animation (required), slot (required), time (required), +4 more.

spine_shift_keyframesC

将指定动画、时间范围和目标过滤器内的关键帧整体前后平移。

Inputs: filePath (required), animation (required), deltaTime (required), range, +4 more.

spine_validate_jsonB

校验结构、版本、引用关系、关键帧排序和插槽附件引用。

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 36 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose, covering different aspects of Spine animation editing (getting info, modifying keyframes, managing animations, preview, validation). Even similar-sounding tools like get_animations, get_animation_sheet, and get_animation_timelines serve different granularities of data.

    Naming Consistency5/5

    All tools follow a consistent 'spine_verb_noun' pattern (e.g., spine_get_animations, spine_set_bone_keyframe, spine_delete_animation). No mixing of camelCase or inconsistent verb forms.

    Tool Count2/5

    With 36 tools, the count exceeds the 25+ threshold defined as 'too many.' While the tools are detailed and cover a complex domain, the number is high for typical MCP server usage and may overwhelm agents.

    Completeness5/5

    The tool set covers the full lifecycle of Spine animation work: creation, cloning, deletion, keyframe manipulation, pose application, preview, validation, backup, and runtime checking. No obvious gaps in core functionality.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Local MCP server for automating Spine projects via the official CLI, enabling AI tools to inspect, export, import, and add animations to .spine files.
      16
      25
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that converts layered PSD characters into Spine 4.2 rigs with deterministic, parametric 2D/2.5D animations (idle, walk, run, jump, attack, hit) ready for the Spine editor and Unity.
      4
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for creating and editing Effekseer effects with AI agents. It provides tools to manage effect documents, nodes, properties, resources, and curves via stdio.
      5
      MIT