Skip to main content
Glama
deenesjakoruzh
zhoushengmin

Spine MCP Server

by zhoushengmin
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

🦴 Spine MCP Server

中文 EN

AI 驱动的 Spine 3.8.75 动画工作流服务器 — 让 AI 客户端（Trae / Cursor / Claude Desktop）直接控制 Spine。

Node Spine 许可证

📖 概述

Spine MCP Server 是一个基于 MCP (Model Context Protocol) 构建的服务器，将 Spine 3.8.75 Professional 编辑器的能力封装为 70 个 MCP 工具，让 AI 客户端可以直接：

  • 读取 Spine 项目（骨骼、插槽、皮肤、动画、事件、约束）

  • 修改动画关键帧（旋转、平移、缩放、剪切、曲线）

  • 编辑骨骼结构（添加/删除骨骼、插槽、附件、皮肤、换装）

  • 操作约束（IK、变换、路径）和网格（FFD 变形）

  • 拆分图集（从角色插画中提取部件）、自动绑定、重新打包图集

  • 通过 JS 运行时渲染动画预览帧

  • 通过 Cocos Creator 扩展面板一键配置、启动/停止服务并生成 AI 客户端配置

Related MCP server: unreal-animation-mcp

✨ 功能特性

功能

描述

70 个 MCP 工具

覆盖 Spine 全部领域（信息、骨骼、附件、约束、动画、图集、项目）

往返修改

导出 JSON → 修改 → 原位导入，自动备份（.bak）

版本兼容性

锁定 Spine 3.8.75，对其他版本给出友好警告

Cocos 扩展

Cocos Creator 3.8+ 可视化面板 + .ccx 打包

安装向导

一键环境检测 + 配置写入

🔧 环境要求

  • Node.js ≥ 20（已在 v22 上测试）

  • Spine.com（3.8.75 Professional，例如 D:\cocos\SpinePro3.8.75\Spine.com）

  • 可选：Cocos Creator 3.8+（用于扩展面板）

🚀 快速开始

# 1. Install dependencies + build
npm install
npm run build

# 2. Configure Spine path (or run the installer wizard)
npm run installer        # Auto-detect Spine/Cocos/Node and write .env

# 3. Verify
node dist/index.js check
node dist/index.js info "D:/cocos/SpinePro3.8.75/examples/hero/hero-pro.spine"

🤖 MCP 配置

将以下配置添加到你的 Trae / Cursor / Claude Desktop MCP 服务器设置中：

{
  "mcpServers": {
    "spine-mcp": {
      "command": "node",
      "args": ["D:/cocos/spine-mcp-server/dist/index.js", "mcp"],
      "env": { "SPINE_EXE": "D:/cocos/SpinePro3.8.75/Spine.com" }
    }
  }
}

⚠️ 如果 MCP 显示“暂无工具”，请重启你的 AI 客户端，让服务器进程重新加载。

🧩 工具（70 个）

分类

工具

信息（9）

get_project_info · inspect_json · describe · list_animations · list_events · list_constraints · get_attachments · get_animation_detail · render_preview

骨骼结构（10）

control_bone · add_bone · delete_bone · set_bone · mirror_bones · add_slot · delete_slot · set_slot · rename_slot · batch_rename

附件与皮肤（7）

set_attachment · add_attachment · delete_attachment · set_attachment_transform · edit_mesh · set_skin · import_skin

约束（9）

add/set/delete × {ik, transform, path}

动画（19）

add_simple_animation · generate_animation · list_effects · apply_effect · pose_to_animation · mirror_animation · mix_animations · mesh_wave · export_sheet · duplicate/delete/rename_animation · set_animation_settings · control_slot · control_constraint · add_event_keyframe · set_draw_order · set_curve · export_video

工作流（2）

check_project · pipeline

图集与项目（9）

split_atlas · repack_atlas · import_image · export · import · clean · create_project · scale_project · rollback

Cocos 工具链（5）

list_cocos_assets · validate_references · build_skeleton · cut_parts · assemble

🎮 Cocos 扩展

cocos-extension/ 目录提供了一个 Cocos Creator 3.8+ 面板：

  • 安装：扩展管理器 → 本地扩展 → 添加 cocos-extension 目录（或运行 npm run package:ccx 生成 .ccx 文件进行导入）

  • 功能：启动/停止 MCP 服务、扫描项目、生成 AI 配置、服务状态

  • 详见 docs/cocos-extension-README.en.md

🧪 测试

npm run test:all     # Run all test suites (unit + integration + MCP protocol + extension bridge)
npm run test:unit    # Unit tests only (node:test)

测试矩阵：单元测试 20/20 · 阶段 3 37/37 · 阶段 4 45/45 · 阶段 5 13/13 · MCP 协议 10/10（70 个工具）· 扩展桥接 12/12

📚 文档

🗂 项目结构

├── src/                  # Source code (TypeScript)
│   ├── server.ts         # MCP stdio server
│   ├── spine/            # Core: cli-executor / json-handler / export / import / render / split ...
│   ├── tools/            # 70 tools (registered in registry.ts)
│   └── utils/            # Config / logger / error codes / file utilities
├── cocos-extension/      # Cocos Creator extension (panel)
├── scripts/              # Installer wizard / .ccx packaging
├── tests/                # All test suites
└── docs/                 # Specs, manuals, progress

💰 支持

可在 Swarms Marketplace 上获取

📄 许可证

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • spine-mcp

    1425sd
    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
    15
    11
    Apache 2.0

  • unreal-animation-mcp

    tumourlove
    A
    license
    B
    quality
    F
    maintenance
    Enables AI agents to inspect, search, and edit Unreal Engine animation data including sequences, montages, blend spaces, animation blueprints, skeletons, and skeletal meshes via 62 tools over MCP.
    61
    MIT

  • spine-mcp

    yb901104-wq
    F
    license
    B
    quality
    C
    maintenance
    MCP server for reading, validating, and modifying Spine 4.1.24 JSON animation files, with tools for animation timeline editing, validation, preview, and agent integration.
    36
    -

  • Houdini MCP

    OtakuSquirrel
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to directly control SideFX Houdini, including creating nodes, setting parameters, executing Python, capturing viewports, and rendering frames, via 57 MCP tools.
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhoushengmin/spine-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server