SpriteCook

spritecook-mcp

将你的 AI Agent（Cursor、VS Code、Claude、Codex、Grok Build 等）连接到 SpriteCook，以 AI 驱动像素艺术和游戏素材生成。

快速设置

npx spritecook-mcp setup

此操作将：

1. 检测已安装的 AI 客户端，包括 Grok Build
2. 验证身份：在需要时使用 API 密钥；Grok Build 使用由主机管理的 OAuth
3. 配置MCP 连接
4. 安装可选的 Agent 技能，以实现更智能的 AI 集成

可选技能包含最新指导，涵盖异步任务轮询、规范的 sprite_url 输出、模型发现、GPT-Image-2 质量设置、引导式角色工作流、已保存的预设、多图像风格指南参考、本地文件上传、背景清理、素材整理与恢复，以及可用于 Godot 的角色导出。

你将获得什么

完成设置后，你的 AI Agent 可以直接生成像素艺术和游戏素材：

“生成一把 64x64 的像素艺术剑精灵图”

“为我的平台游戏创建一张角色精灵图表”

“制作一组带透明背景的药水图标”

“使用我的角色预设生成一个新的待机精灵图”

“导入这个本地 Boss PNG，然后为它制作慢速待机动作动画”

“移除这个角色素材的背景，并提供透明 PNG”

“将生成的剑素材重命名为 Iron Sword Pickup”

手动配置

如果你更倾向于手动配置，请将以下内容添加到编辑器的 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

在 Grok Build 中打开 /mcps 并验证 spritecook。Grok 会存储并刷新 OAuth 凭据，而不会将其暴露给模型。如果工具未显示，请运行 grok mcp doctor spritecook 和 grok inspect。

仓库还包含用于提交到 Grok Build 市场的根目录 .mcp.json。发布市场列表是单独的发布步骤。

环境变量

• SPRITECOOK_API_URL - 覆盖 API 基础 URL（用于本地开发）

链接

• SpriteCook - AI 游戏素材生成器
• API 文档 - 完整 API 参考
• 获取 API 密钥 - 注册并管理 API 密钥