한국어 |

GitHub는 기본적으로 이 English README.md를 보여줍니다. 중국어 버전은 README.zh-CN.md에 유지됩니다.

Windows에서 Spine 자동화를 위한 로컬 MCP 서버. 공식 Spine CLI를 호출하고 stdio에 통신하므로 Claude Code, Codex, Cursor와 같은 AI 도구는 로컬로 시작할 수 있습니다.

이 서버는 UI 자동화, AutoHotkey, 마우스 또는 키보드 시뮬레이션, 타임 라인 운영, 메쉬 바인딩, 뼈 무게 편집, 또는 직접 .spine 내부 수정을하지 않습니다. 공식 Spine CLI를 통해 .spine] 파일을 수정합니다.

요구 사항

• 윈도우
• Node.js 20 이상
• Spine는 로컬에 설치했습니다. 이 MCP는 Spine을 포함하지 않으며 로컬 Spine 설치없이 실행할 수 없습니다.
• Spine CLI 실행 가능:
• SPINE_EXE], Spine.com]에 가해
• 또는 Spine] PATH]에서 사용 가능한 명령

Spine 버전 호환성

이 MCP 패키지는 버전입니다 0.1.0.

이 프로젝트의 Spine CLI 명령 구조는 로컬 Spine Pro / Spine Launcher 3.8.75에 대해 확인되었습니다. 특히 Spine 3.8.75는 수출 명령을 사용하여 수출 설정 JSON 파일을 사용합니다

spine-mcp

English | 简体中文

GitHub shows this English README.md by default. The Chinese version is maintained in README.zh-CN.md.

Local MCP server for Spine automation on Windows. It only calls the official Spine CLI and communicates over stdio, so AI tools like Claude Code, Codex, and Cursor can start it locally.

This server does not do UI automation, AutoHotkey, mouse or keyboard simulation, timeline operations, mesh binding, bone weight editing, or direct .spine internals modification. It only modifies .spine files through the official Spine CLI.

Requirements

• Windows
• Node.js 20+
• Spine installed locally. This MCP does not include Spine and cannot run without a local Spine installation.
• A Spine CLI executable available as either:
  • SPINE_EXE, preferably pointing to Spine.com
  • or a Spine command available on PATH

Spine Version Compatibility

This MCP package is version 0.1.0.

The Spine CLI command construction in this project has been checked against local Spine Pro / Spine Launcher 3.8.75. In particular, Spine 3.8.75 requires export commands to use an export settings JSON file:

Spine -i "" -o "" -e ""

If a command fails even though the input paths are correct, first check whether your local Spine version has different CLI flags or export behavior. Run:

& "$env:SPINE_EXE" --help

Then compare the output with the command shown by the MCP result. Different Spine versions may require different export settings JSON formats, support different flags, or reject commands that work in 3.8.75.

Install

cd G:\spine-mcp
npm.cmd install

Configure Spine

Recommended: point SPINE_EXE to your local Spine.com. The example below is the default install style, but use the actual path for your own Spine installation.

$env:SPINE_EXE = "C:\Program Files\Spine\Spine.com"

Example for a custom local install path:

$env:SPINE_EXE = "E:\BaiduNetdiskDownload\Spine pro 3.8.75+K'D\Spine.com"

Confirm the CLI is reachable and note the version:

& "$env:SPINE_EXE" --help

To persist it for future PowerShell sessions:

[Environment]::SetEnvironmentVariable("SPINE_EXE", "C:\Program Files\Spine\Spine.com", "User")

If SPINE_EXE is not set, the server runs Spine directly.

Build

npm.cmd run build
npm.cmd run typecheck

Start

node G:\spine-mcp\build\index.js

The server uses stdio. Do not expect normal terminal output on stdout because stdout is reserved for the MCP protocol. Diagnostic logs go to stderr.

Add To Claude Code

Basic setup:

claude mcp add --transport stdio spine-mcp -- node G:\spine-mcp\build\index.js

With an explicit Spine CLI path: