日本語 | English

GitHub はデフォルトでこの英語 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: