🦴 Spine MCP Server

ИИ-управляемый сервер для анимационного рабочего процесса Spine 3.8.75 — позволяет ИИ-клиентам (Trae / Cursor / Claude Desktop) напрямую управлять Spine.

📖 Обзор

Spine MCP Server — это сервер, построенный на MCP (Model Context Protocol), который оборачивает возможности редактора Spine 3.8.75 Professional в 70 MCP-инструментов, позволяя ИИ-клиентам напрямую:

• Читать проекты Spine (кости, слоты, скины, анимации, события, ограничения)

• Изменять ключевые кадры анимации (поворот, перемещение, масштаб, сдвиг, кривые)

• Редактировать структуру скелета (добавлять/удалять кости, слоты, вложения, скины, смену нарядов)

• Управлять ограничениями (IK, трансформация, путь) и мешами (деформация FFD)

• Разделять атласы (извлекать части из иллюстраций персонажей), автоматически риггить, перепаковывать атласы

• Рендерить кадры предпросмотра анимации через JS-рантайм

• Настраивать в один клик, запускать/останавливать сервис и генерировать конфиги для ИИ-клиентов через панель расширения Cocos Creator

Related MCP server: unreal-animation-mcp

✨ Возможности

🔧 Требования

• 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

Добавьте следующую конфигурацию в настройки MCP-сервера вашего Trae / Cursor / Claude Desktop:

{
  "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 показывает «Нет инструментов», перезапустите ваш ИИ-клиент, чтобы серверный процесс перезагрузился.

🧩 Инструменты (70)

🎮 Расширение Cocos

Каталог cocos-extension/ предоставляет панель для Cocos Creator 3.8+:

• Установка: Менеджер расширений → Локальное расширение → Добавить каталог cocos-extension (или выполнить npm run package:ccx для генерации файла .ccx для импорта)

• Возможности: Запуск/остановка MCP-сервиса, сканирование проектов, генерация ИИ-конфига, статус сервиса

• Подробности см. в 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

📚 Документация

• Руководство пользователя (EN)

• Руководство пользователя (中文)

• README расширения Cocos (EN)

• README расширения Cocos (中文)

🗂 Структура проекта

├── 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