Английский | 中

GitHub показывает этот английский по умолчанию. Китайская версия поддерживается в README.zh-CN.md.

Локальный MCP-сервер для автоматизации позвоночника в Windows. Он вызывает только официальный Spine CLI и общается через stdio, поэтому инструменты ИИ, такие как Claude Code, Codex и Cursor, могут запускать его локально.

Этот сервер не выполняет автоматизацию пользовательского интерфейса, моделирование AutoHotkey, мыши или клавиатуры, операции по временной шкале, связывание сетки, редактирование веса кости или прямую модификацию внутренних компонентов .spine. Он изменяет файлы только через официальный Spine CLI.

Требования

• Windows Node.js 20+
• Спина установлена локально. Этот MCP не включает Spine и не может работать без локальной установки Spine.
• Исполняемый Spine CLI доступен как:
• [[Т4]], предпочтительно указывающий на [[Т5]] или [[Т6]], [[Т7]], [[Т7]]

Совместимость Spine Version

Этот пакет 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: