API ВЕГА
English

spritecook-mcp

Подключите своего ИИ-агента (Cursor, VS Code, Claude, Codex, Grok Build и другие) к SpriteCook, чтобы создавать пиксельную графику и игровые ресурсы с помощью ИИ.

Быстрая настройка

npx spritecook-mcp setup

Эта команда:

  • Обнаружит установленные клиенты ИИ, включая Grok Build

  • Выполнит аутентификацию с помощью API-ключа, если это необходимо; в Grok Build используется OAuth, управляемый хостом

  • Автоматически настроит подключения MCP

  • Установит дополнительный навык агента для более эффективной интеграции с ИИ

Дополнительные навыки содержат актуальные рекомендации по опросу асинхронных задач, каноническому выводу sprite_url, обнаружению моделей, настройке качества GPT-Image-2, пошаговой работе с персонажами, сохранённым пресетам, использованию нескольких изображений в качестве образцов стиля, загрузке локальных файлов, удалению фона, организации и восстановлению ресурсов, а также экспорту персонажей, готовых для Godot.

Что вы получите

После настройки ваш ИИ-агент сможет создавать пиксельную графику и игровые ресурсы напрямую:

«Создай спрайт меча размером 64x64 в пиксельном стиле»

«Создай лист спрайтов персонажа для моей платформенной игры»

«Создай набор иконок зелий с прозрачным фоном»

«Используй пресет моего персонажа для нового спрайта в состоянии покоя»

«Импортируй этот локальный PNG-файл босса, а затем добавь ему медленную анимацию покоя»

«Удали фон у этого ресурса с персонажем и предоставь PNG с прозрачным фоном»

«Переименуй созданный ресурс меча в „Железный меч для подбора“»

Ручная настройка

Если вы предпочитаете настроить всё вручную, добавьте следующий блок в конфигурацию MCP вашего редактора:

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "spritecook": {
      "url": "https://api.spritecook.ai/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/settings.json):

{
  "mcp": {
    "servers": {
      "spritecook": {
        "type": "http",
        "url": "https://api.spritecook.ai/mcp/",
        "headers": { "Authorization": "Bearer YOUR_API_KEY" }
      }
    }
  }
}

Grok Build (.grok/config.toml или ~/.grok/config.toml):

[mcp_servers.spritecook]
url = "https://api.spritecook.ai/mcp/oauth"
enabled = true
tool_timeout_sec = 6000

Откройте /mcps в Grok Build и пройдите аутентификацию для spritecook. Grok хранит и обновляет учётные данные OAuth, не передавая их модели. Если инструменты не появились, выполните grok mcp doctor spritecook и grok inspect.

В корне репозитория также находится файл .mcp.json для публикации в каталоге Grok Build. Публикация записи в каталоге выполняется отдельно в рамках выпуска.

Переменные окружения

  • SPRITECOOK_API_URL — переопределяет базовый URL API (для локальной разработки)

Ссылки