spine-mcp
This is a TypeScript MCP server for safely inspecting, validating, editing, previewing, and backing up Spine JSON projects, with V1 writes primarily limited to animation timelines.
Inspect Spine JSON: document summaries, official spec summary, skeleton hierarchy, slots, skins, animations, timelines, and keyframe sheets.
Validate Spine JSON structure, version, references, keyframe ordering, and attachment references; verify assets load with official spine-core runtime.
Create, clone, and delete animations.
Edit animation timelines: bone rotate/translate/scale/shear keyframes, slot attachment keyframes, and draw order keyframes.
Batch-edit animations: shift/scale/delete/copy keyframe ranges, apply multi-bone/slot pose keyframes or pose sequences, offset bone timeline values, close loops, and remove keyframes.
Use dryRun defaults, expected hashes, confirmations, backups, backup listing, and protected restore for safer writes.
Generate browser preview URLs/configs, check preview assets, and run a post-write validation pipeline.
Manage Agent handshake/connection status and preview session state for WinForms/browser observers.
V1 intentionally does not modify setup pose, bones, slots, skins, mesh/deform, constraints, or events.
Provides tools for reading, validating, and modifying Spine 4.1.24 JSON files, including animation timeline editing, with support for browser preview and WinForms observation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@spine-mcp validate skeleton-4.1.json"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 testRelated 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 -CheckOnlydotnet run --project apps/winforms-observer/SpineMcp.WinFormsObserver.csprojWinForms 只观察和预览,不直接编辑 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 toolsspine_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
Scored across 36 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that provides asset auto generator
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for agentverse documentation, generated by doc2mcp.
Related MCP Servers
- AlicenseAqualityDmaintenanceLocal MCP server for automating Spine projects via the official CLI, enabling AI tools to inspect, export, import, and add animations to .spine files.1625Apache 2.0
- AlicenseAqualityDmaintenanceAn 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.45MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for creating and editing Effekseer effects with AI agents. It provides tools to manage effect documents, nodes, properties, resources, and curves via stdio.5MIT
- FlicenseAqualityDmaintenanceMCP server for creating Spine 2D animations from cut-up characters, generating runtime skeletons, packed atlases, and editable Spine projects.911-