Spine Render

top.lain42Published by lain42.topOfficial publisherv0.1.1Updated Nov 4, 2026

Render Spine 3.8 skeleton animations to PNG frames or GIF. Pay per call with points.

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

Remote MCP endpoint that renders Spine 3.8 skeletons to transparent PNG frames or animated GIFs, billed per call in points.

What you can do
  • Inspect a Spine skeleton: parse skel and atlas data and return a summary with version, bone count and animation list.
  • Check pricing: read the service's price and limit card at no cost.
  • Render a single posed frame as a transparent-background PNG, returning base64 image data.
  • Render a skeleton animation as a GIF, returning base64 image data.
  • Retries with the same request_id are idempotent and are not charged twice.
When to use it
Useful when an assistant needs to preview or export Spine 3.8 character art — checking what a skeleton contains, producing a still frame, or generating an animated GIF — without running a local renderer or holding a Spine runtime license.
Requirements
A remote streamable HTTP endpoint; no local package. A bearer token from a lain42 studio account, sent in the Authorization header; registration is free and includes 25 trial points. Rendering calls consume points (5 per frame, 20 per animation).
Before you install
Rendering spends prepaid points, so calls cost money once trial points run out; check the pricing card first. The bearer token is a billing credential and should be kept private. Skeleton, atlas and page image data are uploaded to the remote service as base64.

Installation

In SourceWeft

  1. Open Spine Render in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/top.lain42%2Fspine-render/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "spine-render": {
      "type": "http",
      "url": "https://lain42.top/studio/render/mcp-server/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

lyco-ai-toolkit

多模态 AI 资源流水线：一条命令产出 Minecraft 皮肤、Bedrock 模型、BGM、立绘、歌词。

Owner: lilyco-42（云枢智创数码信息科技服务工作室） 调研与决策记录在 _RESEARCH/

现在能做什么

bash
lyco-cli bundle --prompt 'a quiet librarian' --out out# => out/#      skin.png        64x64 Minecraft 皮肤（合法，可校验）#      model.geo.json  Bedrock 几何（Blockbench 可导入）#      bgm.wav         背景音乐#      portrait.png    立绘 512x512#      lyrics.txt      分段歌词#      manifest.json   每个产物的 backend 与 placeholder 标记

全部子命令

lyco-cli bundle    整包：skin + model + bgm + portrait + lyrics + manifestlyco-cli skin      template | validate | info | quantize | generatelyco-cli bsm       humanoid | validate | info | glb-info | from-glblyco-cli bgm       背景音乐lyco-cli lyrics    分段歌词lyco-cli portrait  单张立绘lyco-cli mcp       在 stdin/stdout 上跑 MCP server，给 agent 用

接入 agent（MCP）

lyco-cli mcp 是一个 MCP server，用换行分隔的 JSON-RPC 2.0 收发。它把 12 个工具 暴露给 lilyco_agent / Claude Code / Cursor：skin_template、skin_validate、 skin_quantize、model_humanoid、model_validate、glb_info、model_from_glb、 lyrics_generate、lyrics_validate、bgm_generate、portrait_generate、bundle。

手动试一次：

bash
printf '%s\n' \  '{"jsonrpc":"2.0","id":1,"method":"initialize"}' \  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \  | lyco-cli mcp

布局

lyco-ai-toolkit/+-- crates/|  +-- lyco-cli/        统一入口（clap）|  +-- lyco-mc-skin/    F1  64x64 box-UV、调色板量化、皮肤校验|  +-- lyco-bsm/        F2/F3 Bedrock 几何、玩家模型、GLB 解析、体素化转换|  +-- lyco-audio/      F6  WAV 编解码、生成后端（stub + 子进程）|  +-- lyco-image/      F7  程序化立绘、生成后端|  +-- lyco-lyrics/     F8  歌词解析与结构校验、生成后端|  +-- lyco-bundle/     S5  编排 + 自描述 manifest|  +-- lyco-mcp/        F9  MCP server（JSON-RPC over stdio）+-- _RESEARCH/          lyco skill 预研报告（00-04）+-- scripts/            测试夹具生成器（造 GLB）

三个设计原则

  1. 解码大于编码。 音频、图像、歌词写完都要解回来核对；绝不把子进程退出码 当作产出成功的证据。
  2. placeholder 必须显眼。 内置 stub 后端在 CLI、manifest 的 placeholder 字段和 notes 里三处标注，一个 bundle 永远不会看起来像五次真实生成。
  3. 需要模型的藏在子进程后面。 不对 ACE-Step / ComfyUI / 任何 LLM 的 CLI 做假设， 只约定参数形状，用 --backend 指过去。

生成：Kaggle 免费 GPU

皮肤生成真的能跑 —— 不需要本机有显卡：

bash
lyco-cli skin generate --backend kaggle --owner <you> --slug lyco-skin-gen --seeds 7,42

它把 Rust 生成的笔记本推到 Kaggle，在免费的 Tesla T4 上跑 AliceKJ/BLOCKv0.6， 轮询到结束，拉回产物，然后在本机做 overlay 修复、结构校验和人形预览。

分工是刻意的：Kaggle 只做它唯一不可替代的事（GPU 推理），UV 知识和修复逻辑归 Rust。 生成的笔记本里没有 UV 表，CI 会断言这一点。

其余需要模型的部分（音频引擎、图像引擎、LLM）仍是 --backend '<命令行>' 子进程边界。

F11 Spine：渲染，以及为什么它不随包发布

bash
lyco-cli spine info model.atlas        # 页 / region / 是否声明 size、pmalyco-cli spine normalize model.atlas   # 从 PNG 头补/修 size，幂等lyco-cli spine version model.skel      # 读出需要的 Spine 版本

lyco-spine-render 能把 Spine 骨架摆姿势并在 CPU 上画成 PNG（describe / render --animation NAME）。已用真实方舟数据验证：Spine 3.8.99、52 mesh、508 三角形。

但它不随本仓库发布二进制，原因很具体：

  • 它链接官方 Spine 运行时，那是 Spine Runtimes License Agreement（商业许可）
  • 本仓库源码是 MIT，从它构建出的二进制不是 —— 发布需要你自己的 Spine 授权
  • 所以默认 CI 只验证它能编译，不产出 artifact；windows-binary 只发纯 MIT 的 lyco-cli.exe

要拿到这个二进制，用仓库里的 build from source workflow（workflow_dispatch）： 你在自己的 fork 里触发，在你自己的授权下构建，产物只进你这次 run。

它的输入：

  • target —— 默认 lyco-spine-render，也可选 lyco-cli 或 both
  • runner —— 默认 windows-latest，或 ubuntu-latest
  • spine_lib —— 要链接的 Spine 运行时 git 地址（默认 rusty_spine3.8）
  • spine_rev —— 该运行时的 revision，commit / tag / branch 都行

spine_lib 和 spine_rev 是真的生效的：workflow 会改写 crates/lyco-spine-render/Cargo.toml 里那一行再开始构建，所以你可以拿它试别的运行时。 运行时地址、revision、许可链接会在构建开头打印，并且参与缓存 key， 换 revision 不会误用旧产物。

缓存：默认 CI 和这个 workflow 都缓存两层 —— ~/.cargo/git/db 与 ~/.cargo/git/checkouts（Spine 运行时那个 git 依赖的 clone， 冷启动最慢的一步），以及 rust-cache 管的 target/ 增量编译。

注意：pma 是 Spine 4.x 的键。 往 3.8 的 atlas 里写 pma: true 会让 3.8 运行时 完全读不了那个文件 —— 实测确认（方舟素材池 561 组里 243 组带着它）。两条路都通：

  • 渲染时自动剥离：lyco-spine-render 读取前把 3.8 认不了的字段剥掉（旁路写一份 临时 atlas，用完即删），561/561 全部可读可渲；
  • 离线修复：lyco-cli spine normalize <atlas> --strip-3-8 把剥离结果写回文件。

验证

每次 CI 跑：test → clippy -D warnings → build → 6 组冒烟测试 → fmt。 冒烟测试用外部实现交叉验证：Python 的 wave 解码我们写的 WAV、直接读 PNG 头核对尺寸、 现造 GLB 喂给转换、以及一次真实 MCP 会话。

已知缺口

  • 真实 ACE-Step / ComfyUI / 混元 3D / LLM 接入需要 GPU 机器（皮肤走 Kaggle 已通）
  • keep-percent=12% 这个启发式对某些 seed 会整体清空残留很少的 overlay 矩形， 可能丢掉真实衣物细节；需要人眼判断是否调低
  • BGM 目前是 WAV；mp3 转码需要 ffmpeg
  • 转换出的模型贴图是「每盒平均色」，不是对原网格纹理的 UV 重映射
  • 模型能否被 Blockbench 导入未经人工验证（自动化只能验到 schema 层）

术语更正

调研初稿曾写「YSM/BSM 是 BlockBench 格式」——错的，已在 _RESEARCH/02-niche-knowledge.md 第五节更正： Blockbench 没有这两个格式且是 GPL-3.0；YSM 是 Yes Steve Model 模组的加密二进制； BSM 不存在。本项目落点是开放的 Bedrock geometry。

许可

MIT

Source: README.md at commit 92bb7f0

Tools

4

spine_render_pricing

Spine 渲染服务定价与限制卡片（免费调用）。

Takes no parameters.

spine_describe

解析 Spine 骨骼并返回摘要（版本/骨骼数/动画列表等，免费）。 atlas/skel 为 base64 文本，pages 为 [{"name": "...", "png": "<base64>"}]。

Parametersskelatlaspagestoken

spine_render_frame

渲染骨骼单帧为透明背景 PNG（5 积分）。返回 base64 图像。 token 为 studio-billing Bearer 令牌（也可走 HTTP Authorization 头）。 request_id 幂等：同 id 重试不会二次扣费。include_image=False 时只返回计费元信息。

Parametersskeltimeatlaspagestokenwidthanchorheightanimationbackgroundrequest_idinclude_image

spine_render_animate

渲染骨骼动画为 GIF（20 积分）。返回 base64 图像。 token 为 studio-billing Bearer 令牌（也可走 HTTP Authorization 头）。 request_id 幂等：同 id 重试不会二次扣费。

Parametersfpsskelatlaspagestokenwidthanchorframesheightanimationbackgroundrequest_id+1 more

Version history

1
  1. v0.1.1LatestOct 21, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts