@simpligen/mcp 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simpligen/mcp",
-  "version": "0.1.1",
+  "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/client.js

@@ -46,6 +46,7 @@ export class ControlApiClient {
   getStatus() { return this.#req('GET', '/status'); }
   listProjects() { return this.#req('GET', '/projects'); }
   createProject(name) { return this.#req('POST', '/projects', { name }); }
+  listLoras() { return this.#req('GET', '/loras'); }
   generate(args) { return this.#req('POST', '/generate', args); }
   getJob(id) { return this.#req('GET', `/jobs/${encodeURIComponent(id)}`); }
   listJobs() { return this.#req('GET', '/jobs'); }
@@ -67,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

@@ -7,12 +7,13 @@ import { buildResultImageContent } from './resultImage.js';
 
 export const TOOL_NAMES = [
   'list_capabilities', 'get_status', 'list_projects', 'create_project',
-  'upload_file', 'generate', 'get_job', 'wait_for_result', 'list_jobs',
+  'upload_file', 'generate', 'list_loras', 'get_job', 'wait_for_result', 'list_jobs',
   'cancel_job', 'prepare_preset', 'get_result_image',
   'list_characters', 'get_character', 'list_character_features', 'list_character_presets',
   '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) }] });
@@ -50,11 +51,16 @@ export function registerTools(server, client) {
         image: z.string().optional().describe('upload_file handle'),
         referenceImages: z.array(z.string()).optional().describe('upload_file handles'),
         video: z.string().optional().describe('upload_file handle (driving video)'),
+        loras: z.array(z.object({ name: z.string().describe('LoRA display name from list_loras'), weight: z.number().optional().describe('Strength; defaults to the LoRA default') })).optional().describe('LoRAs to apply. Local backend only, and only for presets where inputs.supportsLoras is true. Use the LoRA trigger words in the prompt so it activates.'),
         options: z.object({ resolution: z.string().optional(), aspectRatio: z.string().optional().describe('Aspect ratio, e.g. "1:1", "16:9", "9:16" (portrait/vertical), "4:3", "3:4". See list_capabilities -> options.aspectRatio for the values each preset accepts. Defaults to 1:1 for images (16:9 for video) if omitted.'), durationSeconds: z.number().optional(), steps: z.number().optional(), cfg: z.number().optional(), seed: z.number().optional() }).optional(),
       },
     },
     wrap((args) => client.generate(args)));
 
+  server.registerTool('list_loras',
+    { title: 'List LoRAs', description: 'List the installed user LoRAs (name, base model, trigger words) so you can pass them in generate -> loras.', inputSchema: {} },
+    wrap(() => client.listLoras()));
+
   server.registerTool('get_job',
     { title: 'Get job', description: 'Status + result of a generation job. resultPath is the local file when completed.', inputSchema: { jobId: z.string() } },
     wrap(({ jobId }) => client.getJob(jobId)));
@@ -302,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 })));
 }