spritecook-mcp 0.2.13 → 0.2.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SpriteCook
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,7 +13,9 @@ This will:
 1. **Authenticate** your SpriteCook account (browser-based or manual API key)
 2. **Detect** your editors (Cursor, VS Code, Claude Desktop, Claude Code)
 3. **Configure** MCP connections automatically
-4. **Install** an optional agent skill for smarter AI integration
+4. **Install** an optional agent skill for smarter AI integration
+
+The optional skills include current guidance for model discovery, GPT-Image-2 quality settings, guided character workflows, saved presets, multi-image style guide references, importing local image bytes with `import_asset(...)`, cleaning up backgrounds with `remove_background(...)`, renaming assets with `update_asset_label(...)`, recovering lost asset IDs with `list_recent_assets(...)`, using the primary asset URL instead of lower-level variant fields, and exporting SpriteCook character animations into Godot-ready scenes.
 
 ## What You Get
 
@@ -23,7 +25,15 @@ After setup, your AI agent can generate pixel art and game assets directly:
 
 > "Create a character sprite sheet for my platformer game"
 
-> "Make a set of potion icons with transparent backgrounds"
+> "Make a set of potion icons with transparent backgrounds"
+
+> "Use my character preset for a new idle sprite"
+
+> "Import this local boss PNG, then animate it with a slow idle motion"
+
+> "Remove the background from this character asset and give me the transparent PNG"
+
+> "Rename the generated sword asset to Iron Sword Pickup"
 
 ## Manual Configuration
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "spritecook-mcp",
-  "version": "0.2.13",
+  "version": "0.2.17",
   "mcpName": "ai.spritecook/generate",
-  "description": "SpriteCook MCP Server - Connect your AI agent (Cursor, VS Code, Claude) to SpriteCook for pixel art and game asset generation.",
+  "description": "SpriteCook MCP Server - Connect your AI agent to SpriteCook for game asset generation, saved presets, import, background cleanup, asset organization, inspection, and animation.",
   "keywords": [
     "spritecook",
     "mcp",

package/src/skill.mjs

@@ -1,124 +1,140 @@
-import { execSync } from 'node:child_process';
-import { platform } from 'node:os';
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { basename, dirname, join } from 'node:path';
-import prompts from 'prompts';
-import { success, info, warn } from './ui.mjs';
-
-const SKILLS = [
-  {
-    name: 'spritecook-workflow-essentials',
-    rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-workflow-essentials/SKILL.md',
-  },
+import { execSync } from 'node:child_process';
+import { platform } from 'node:os';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import prompts from 'prompts';
+import { success, info, warn } from './ui.mjs';
+
+const SKILLS = [
+  {
+    name: 'spritecook-workflow-essentials',
+    rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-workflow-essentials/SKILL.md',
+  },
   {
     name: 'spritecook-generate-sprites',
     rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-generate-sprites/SKILL.md',
   },
+  {
+    name: 'spritecook-generate-tilesets',
+    rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-generate-tilesets/SKILL.md',
+  },
   {
     name: 'spritecook-animate-assets',
     rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-animate-assets/SKILL.md',
   },
+  {
+    name: 'spritecook-use-presets',
+    rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-use-presets/SKILL.md',
+  },
+  {
+    name: 'spritecook-use-assets-in-godot',
+    rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-use-assets-in-godot/SKILL.md',
+  },
+  {
+    name: 'spritecook-use-dual-grid-tilesets',
+    rawUrl: 'https://raw.githubusercontent.com/SpriteCook/skills/main/skills/spritecook-use-dual-grid-tilesets/SKILL.md',
+  },
 ];
-
-/**
- * Download SKILL.md directly from GitHub and write it into each
- * selected editor's skill directory.  Used as a fallback when
- * `npx skills add` fails (e.g. git not installed).
- *
- * @param {Array<{skillDirs:{project:string|null,global:string|null}, _chosenScope?:string}>} editors
- */
-async function fallbackInstall(editors) {
-  info('Trying direct download fallback...');
-
-  const skillBodies = [];
-  try {
-    for (const skill of SKILLS) {
-      const res = await fetch(skill.rawUrl);
-      if (!res.ok) throw new Error(`${skill.name}: HTTP ${res.status}`);
-      skillBodies.push({
-        name: skill.name,
-        body: await res.text(),
-      });
-    }
-  } catch (e) {
-    warn(`Could not download skill files: ${e.message}`);
-    return false;
-  }
-
-  let wrote = 0;
-  for (const editor of editors) {
-    const dirs = editor.skillDirs;
-    if (!dirs) continue;
-
-    const scope = editor._chosenScope || 'project';
-    const dir = dirs[scope] || dirs.project || dirs.global;
-    if (!dir) continue;
-
-    const skillsRoot = basename(dir) === 'spritecook' ? dirname(dir) : dir;
-
-    try {
-      for (const skill of skillBodies) {
-        const skillDir = join(skillsRoot, skill.name);
-        mkdirSync(skillDir, { recursive: true });
-        writeFileSync(join(skillDir, 'SKILL.md'), skill.body, 'utf-8');
-        wrote++;
-      }
-    } catch {
-      // best-effort, skip on failure
-    }
-  }
-
-  if (wrote > 0) {
-    success(`Agent skills installed via direct download (${wrote} files written).`);
-    return true;
-  }
-  return false;
-}
-
-/**
- * Install or update the SpriteCook agent skill.
- *
- * Primary: `npx skills add SpriteCook/skills --skill '*'` (requires git).
- * Fallback: download SKILL.md directly from GitHub and place it
- *           in each selected editor's skill directory.
- *
- * @param {Array} [selectedEditors] - editors the user chose in step 3
- */
-export async function maybeInstallSkill(selectedEditors = []) {
-  info('The agent skill teaches your AI how to generate sprites autonomously.');
-  const response = await prompts({
-    type: 'confirm',
-    name: 'install',
-    message: 'Install SpriteCook agent skill? (highly recommended)',
-    initial: true,
-  });
-
-  if (!response.install) {
-    return;
-  }
-
-  info('Installing skills via npx skills add SpriteCook/skills --skill "*" ...');
-
-  try {
-    const npxCmd = platform() === 'win32' ? 'npx.cmd' : 'npx';
-    execSync(`${npxCmd} -y skills add SpriteCook/skills --skill "*"`, {
-      stdio: 'inherit',
-      timeout: 60_000,
-    });
-    success('Agent skills installed.');
-    return;
-  } catch {
-    // Primary method failed -- try fallback
-  }
-
-  // ── Fallback: direct download ────────────────────────────────────
-  if (selectedEditors.length > 0) {
-    const ok = await fallbackInstall(selectedEditors);
-    if (ok) return;
-  }
-
-  warn('Skill install failed (git may not be installed).');
-  console.log('  You can install it manually later:');
-  console.log('    npx skills add SpriteCook/skills --skill "*"');
-  console.log('  Or install git and re-run this setup.');
-}
+
+/**
+ * Download SKILL.md directly from GitHub and write it into each
+ * selected editor's skill directory.  Used as a fallback when
+ * `npx skills add` fails (e.g. git not installed).
+ *
+ * @param {Array<{skillDirs:{project:string|null,global:string|null}, _chosenScope?:string}>} editors
+ */
+async function fallbackInstall(editors) {
+  info('Trying direct download fallback...');
+
+  const skillBodies = [];
+  try {
+    for (const skill of SKILLS) {
+      const res = await fetch(skill.rawUrl);
+      if (!res.ok) throw new Error(`${skill.name}: HTTP ${res.status}`);
+      skillBodies.push({
+        name: skill.name,
+        body: await res.text(),
+      });
+    }
+  } catch (e) {
+    warn(`Could not download skill files: ${e.message}`);
+    return false;
+  }
+
+  let wrote = 0;
+  for (const editor of editors) {
+    const dirs = editor.skillDirs;
+    if (!dirs) continue;
+
+    const scope = editor._chosenScope || 'project';
+    const dir = dirs[scope] || dirs.project || dirs.global;
+    if (!dir) continue;
+
+    const skillsRoot = basename(dir) === 'spritecook' ? dirname(dir) : dir;
+
+    try {
+      for (const skill of skillBodies) {
+        const skillDir = join(skillsRoot, skill.name);
+        mkdirSync(skillDir, { recursive: true });
+        writeFileSync(join(skillDir, 'SKILL.md'), skill.body, 'utf-8');
+        wrote++;
+      }
+    } catch {
+      // best-effort, skip on failure
+    }
+  }
+
+  if (wrote > 0) {
+    success(`Agent skills installed via direct download (${wrote} files written).`);
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Install or update the SpriteCook agent skill.
+ *
+ * Primary: `npx skills add SpriteCook/skills --skill '*'` (requires git).
+ * Fallback: download SKILL.md directly from GitHub and place it
+ *           in each selected editor's skill directory.
+ *
+ * @param {Array} [selectedEditors] - editors the user chose in step 3
+ */
+export async function maybeInstallSkill(selectedEditors = []) {
+  info('The agent skill teaches your AI how to generate sprites autonomously.');
+  const response = await prompts({
+    type: 'confirm',
+    name: 'install',
+    message: 'Install SpriteCook agent skill? (highly recommended)',
+    initial: true,
+  });
+
+  if (!response.install) {
+    return;
+  }
+
+  info('Installing skills via npx skills add SpriteCook/skills --skill "*" ...');
+
+  try {
+    const npxCmd = platform() === 'win32' ? 'npx.cmd' : 'npx';
+    execSync(`${npxCmd} -y skills add SpriteCook/skills --skill "*"`, {
+      stdio: 'inherit',
+      timeout: 60_000,
+    });
+    success('Agent skills installed.');
+    return;
+  } catch {
+    // Primary method failed -- try fallback
+  }
+
+  // ── Fallback: direct download ────────────────────────────────────
+  if (selectedEditors.length > 0) {
+    const ok = await fallbackInstall(selectedEditors);
+    if (ok) return;
+  }
+
+  warn('Skill install failed (git may not be installed).');
+  console.log('  You can install it manually later:');
+  console.log('    npx skills add SpriteCook/skills --skill "*"');
+  console.log('  Or install git and re-run this setup.');
+}