@simpligen/mcp 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simpligen/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "MCP server for SimpliGen -- drive local/cloud AI image & video generation from an agent.",
   "type": "module",
   "license": "MIT",

package/src/bin.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // packages/mcp-server/src/bin.js
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ControlApiClient } from './client.js';

package/src/client.js

@@ -68,6 +68,13 @@ export class ControlApiClient {
   regenerateCharacterBase(id, args) { return this.#req('POST', `/characters/${encodeURIComponent(id)}/regenerate-base`, args); }
   removeCharacter(id) { return this.#req('DELETE', `/characters/${encodeURIComponent(id)}`); }
 
+  listRecipeBlocks() { return this.#req('GET', '/recipe-blocks'); }
+  composeRecipe(args) { return this.#req('POST', '/recipes', args); }
+  validateRecipe(args) { return this.#req('POST', '/recipes/validate', args); }
+  listRecipes() { return this.#req('GET', '/recipes'); }
+  getRecipe(id) { return this.#req('GET', `/recipes/${encodeURIComponent(id)}`); }
+  publishRecipe(id, args) { return this.#req('POST', `/recipes/${encodeURIComponent(id)}/publish`, args); }
+
   async uploadFile(filePath) {
     let buf;
     try {

package/src/tools.js

@@ -13,6 +13,7 @@ export const TOOL_NAMES = [
   'remove_character', 'create_character', 'generate_character_image', 'generate_character_video',
   'generate_character_frame', 'animate_character', 'set_character_preset',
   'enhance_character_media', 'regenerate_character_base',
+  'list_recipe_blocks', 'compose_recipe', 'validate_recipe', 'list_recipes', 'get_recipe', 'publish_recipe',
 ];
 
 const ok = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
@@ -307,4 +308,56 @@ export function registerTools(server, client) {
         }
       } catch (e) { return fail(e); }
     });
+
+  // --- Recipe authoring: compose multi-step recipes out of packs/presets ---
+
+  const recipeStep = z.object({
+    preset: z.string().describe('The preset this step runs, as "packId:presetId" (from list_recipe_blocks).'),
+    entry: z.string().optional().describe('Entry point: create-image | create-video | edit-image | upscale. Inferred from the preset when omitted.'),
+    promptInput: z.object({ key: z.string().optional(), label: z.string().optional() }).optional()
+      .describe('Name this step\'s prompt input, or set key to an existing input to SHARE a prompt. Default: a dedicated prompt input per step.'),
+    negativePrompt: z.string().optional(),
+    params: z.record(z.any()).optional().describe('Param bindings, literal or { from: "input:<key>" } (e.g. aspectRatio, seed, duration).'),
+  }).passthrough();
+
+  const recipeInput = z.object({
+    key: z.string().describe('Unique slug referenced as input:<key>.'),
+    kind: z.string().describe('subject | text | image | video | reference | audio | select | color | number | toggle'),
+    label: z.string().optional(),
+    required: z.boolean().optional(),
+  }).passthrough();
+
+  const recipeSpec = z.object({
+    name: z.string().describe('Recipe name shown to end users.'),
+    description: z.string().optional(),
+    category: z.string().optional().describe('e.g. product | ugc'),
+    nsfw: z.boolean().optional(),
+    version: z.string().optional().describe('Creator-facing semver, default 1.0.0.'),
+    inputs: z.array(recipeInput).optional().describe('Extra user-facing inputs (subjects, choices, media holes). A prompt input is auto-created per step, so you rarely list prompts here.'),
+    steps: z.array(recipeStep).min(1).describe('The pipeline in order. Each step pins a preset; media output flows into the next step automatically, and a subject input seeds a reference port.'),
+  });
+
+  server.registerTool('list_recipe_blocks',
+    { title: 'List recipe blocks', description: 'The building blocks for authoring a recipe: entry points (create-image/video, edit-image, upscale) and every preset usable as a step, each with its port contract (inputs it needs, what it produces, which entry points it fits). Call this before compose_recipe to choose presets.', inputSchema: {} },
+    wrap(() => client.listRecipeBlocks()));
+
+  server.registerTool('compose_recipe',
+    { title: 'Compose a recipe', description: 'Author a new recipe from a high-level spec and save it as a draft. You give an ordered list of steps (each pinned to a preset from list_recipe_blocks) plus any extra inputs; SimpliGen auto-wires the ports, media chain, and per-step prompt inputs and validates it. Returns { recipeId, valid, errors }. Anyone can compose; publishing later needs a connected account.', inputSchema: { spec: recipeSpec } },
+    wrap(({ spec }) => client.composeRecipe({ spec })));
+
+  server.registerTool('validate_recipe',
+    { title: 'Validate a recipe', description: 'Dry-run without saving: pass a `spec` to compose+validate it, or a `config` to validate an existing recipe config. Returns precise errors (unbound ports, missing presets, type mismatches, cycles) to fix before compose_recipe.', inputSchema: { spec: recipeSpec.optional(), config: z.record(z.any()).optional() } },
+    wrap((args) => client.validateRecipe(args)));
+
+  server.registerTool('list_recipes',
+    { title: 'List recipes', description: 'List the recipe drafts saved on this device (id, name, version, category).', inputSchema: {} },
+    wrap(() => client.listRecipes()));
+
+  server.registerTool('get_recipe',
+    { title: 'Get a recipe', description: 'Get a saved recipe and its full config by id.', inputSchema: { id: z.string().describe('Recipe id from compose_recipe or list_recipes') } },
+    wrap(({ id }) => client.getRecipe(id)));
+
+  server.registerTool('publish_recipe',
+    { title: 'Publish a recipe', description: 'Submit a saved recipe to the SimpliGen Creator Marketplace (queued for human review). Requires a connected account: if none, returns not_connected and the user connects once in Settings, then this succeeds on the same recipe. priceTokens sets an optional one-time price (0 or omitted = free). Every preset the recipe uses must be a distributable first-party pack.', inputSchema: { id: z.string().describe('Recipe id to publish'), changelog: z.string().optional(), priceTokens: z.number().optional().describe('One-time price in tokens (0/omitted = free).') } },
+    wrap(({ id, changelog, priceTokens }) => client.publishRecipe(id, { changelog, priceTokens })));
 }