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 License

📖 개요

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에 "No tools yet"이 표시되면 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)

테스트 매트릭스: Unit 20/20 · Phase 3 37/37 · Phase 4 45/45 · Phase 5 13/13 · MCP Protocol 10/10 (70개 도구) · Extension Bridge 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