SpriteShip MCP：将 2D 游戏美术资源引入 AI 编程工作流

大多数编码 Agent 都能写出玩家控制器、注册动画、加载纹理图集。但它们通常在"美术素材必须已经存在"这个节点就停住了。

这个边界对于自主工作流来说很尴尬。图像生成器可以输出一张 PNG，但 Agent 仍然需要猜测如何切割帧、给动画命名、构建图集、定义碰撞体，以及将所有内容打包成引擎可用的格式。

SpriteShip 托管的 Model Context Protocol 服务器正是为了弥合这一缺口。它目前暴露了 41 个工具，用于创建、读取、修改、动画化以及导出一款游戏的 2D 美术资产层。

本文的封面图由 SpriteShip 使用 AI 生成。

Agent 实际能生成什么

这套工具覆盖的不只是角色：

• 动画角色和方向性转身；
• 静态道具和动画对象；
• tileset、地形表、背景图和无缝贴图；
• 由上述资产生成的关卡地图；
• 支持 Phaser、Godot、Unity、GameMaker 和 Tiled 的引擎原生导出格式。

重要的是这个顺序。Agent 可以创建项目、在项目内生成资产、轮询异步任务、检查结果、导出文件，全程无需有人在网页仪表盘中先手动创建好实体。

连接 MCP 服务器

在 SpriteShip 的 Account → API keys 下创建一个带作用域的 API 密钥，然后将其暴露给运行 Agent 的进程：

export SPRITESHIP_API_KEY="ss_live_..."

MCP 客户端配置有三个关键字段：

{
  "mcpServers": {
    "spriteship": {
      "url": "https://spriteship.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SPRITESHIP_API_KEY}"
      }
    }
  }
}

具体的配置文件位置因 Claude Code、Cursor、Windsurf、Cline 和 Codex 而异，但端点和授权头是相同的。

角色和资产存在于项目内部。项目还拥有永久的游戏视角，这个视角会指导后续的生成：platformer（平台跳跃）、angled top-down（斜俯视）、straight overhead（正俯视）、isometric（等距）、或 point-and-click（点击冒险）。

create_project 是同步调用且免费。一个典型的 Agent 指令示例：

Create a platformer project called Clockwork Harbor. Use a hand-drawn style and describe it as a foggy port city powered by unreliable brass machinery.

在创建任何内容之前，Agent 应该调用 list_projects，复用匹配的项目，而不是创建一个几乎重复的项目。

一次图像调用生成四个角色方案

create_character 生成初始角色图像。将 gridRows 和 gridCols 都设为 2，就请求一张四格变体图。这仍然是一次图像调用，因此四张角色设计的生成成本和一张相同。

这构成了一个合理的第一工作流：

1. 请求一套 2×2 的角色变体。
2. 用返回的 jobId 调用 get_job 轮询任务状态。
3. 向用户展示四张 characterPreview。
4. 只对选中的设计进行动画化。

生成是异步的。create_character 调用返回一个 jobId；任务完成后，get_job 返回创建的角色 ID 和过期的预览 URL。

预览成本后再消费

付费的 SpriteShip MCP 工具默认 dryRun: true。试运行返回预估的积分消耗、当前余额、每日消费上限、近消费记录和剩余配额。它不会生成任何内容。

典型的交互流程：

用户：为此项目制作四个瘟疫医生角色概念
Agent：此次生成预估消耗 150 积分。调用后您的余额将为 1350 积分。是否执行？

用户：好的

只有在获得明确批准后，Agent 才能将 dryRun 设为 false 重复调用。

这不是提示词礼仪，而是由服务端控制来保障的：

• API 密钥有独立的 read、write 和 spend 作用域；
• 每个密钥有每日积分上限；
• 真正的写入操作是幂等的，重试不会重复下发和扣费；
• 对繁忙实体的写入会被拒绝而非竞态；
• 撤销密钥会取消其未完成的任务。

当任务进入终态时，Agent 应报告任务的实际净扣费而非重复预估。四张变体仍然来自一次计费的图像调用，失败的步骤可能会改变最终金额。

静帧图像及其动画是有意分开决策的。generate_character_animation 创建图生视频的运动效果，如走路、待机、攻击或闪避。每生成一个动画都是一次独立的付费视频调用，因此 Agent 应该询问实际需要哪些动作。

对于方向性角色，生成一个方向后也可以在同一任务中免费获得一个镜像副本。对于非对称角色，真正的第二次生成仍是正确选择，因为镜像会将手持物品换到另一只手。

最近的动画工作还使生成的运动在下游更好用：

• 起始姿态会检查视觉清单，确保空的手保持空状态，已有的手持物品得以保留；
• 冲突的动画名称会非破坏性地解析（jump、jump_2、jump_3）；
• 跳跃动画可以拆分为起飞、空中和落地阶段；
• 角色导出携带十个派生自骨骼的挂载点，用于装备和特效。

导出引擎可用的格式

角色准备就绪后，get_export_command 返回一个认证 URL 和一条可用于所选引擎的现成 curl 命令。Agent 在自己的 shell 中运行该命令，而不是通过语言模型传递一个数 MB 的 zip 文件。

导出可以包含：

• 精灵图和图集元数据；
• 原生引擎资源；
• 动画名称和帧时序；
• 碰撞形状和地面足迹；
• 每帧装备挂载点；
• 清单、JSON Schema、README 和 SpriteShip skill 说明。

最后这组内容很重要。bundle 解释了自己的结构，所以编码 Agent 可以在游戏中注册动画，而不是凭空发明一个文件布局。

一个有用的端到端提示词

连接服务器后，尝试这样一个指令：

Create a platformer project for a clockwork harbor game. Preview the cost of four character designs for a lantern-carrying mechanic. Wait for my approval before spending anything. When they finish, show me the options and let me pick one. Then quote an idle and walk animation, generate only after I approve, and export the result for Phaser.

这一个请求涵盖了重要的边界：项目上下文、成本预览、明确批准、异步任务、可视化选择、独立的动画消费以及引擎原生导出。

Agent 概览和设置指南：https://spriteship.com/agents

MCP 端点：https://spriteship.com/mcp

API 和密钥管理：https://spriteship.com/account/api-keys

SpriteShip 提供 1500 起始积分，试用第一个工作流无需绑定信用卡。读取现有资产和重新导出是免费的；积分仅用于新的 AI 生成。