AI Agents
Riferimento strumenti MCP
Gli strumenti che il server MCP di SimpliGen espone agli agenti IA, e l'API Control locale sottostante.
SimpliGen include un server MCP (@simpligen/mcp) che connette un agente IA all'app SimpliGen in esecuzione su una connessione locale autenticata tramite token. L'agente chiama strumenti MCP; il server li inoltro all'API Control locale dell'app. Vedi Connetti un agente per configurare questo.
Strumenti
| Strumento | Cosa fa |
|---|---|
list_capabilities | Elenca ogni preset con cui l'agente può generare (immagine o video), i suoi input e opzioni, se è pronto localmente, e l'idoneità cloud e il costo dei crediti. |
get_status | Segnala lo stato del motore, se il cloud è connesso, il saldo dei crediti, il progetto attivo, e il blocco di funzionalità characters (flag abilitato, conteggi dei preset installati per base/edit/i2v, e enhancePresets, il numero di preset di upscale installati). |
start_engine | Avvia il motore locale se non è già in esecuzione. Restituisce lo stato del motore; quando un avvio a freddo supera la durata della chiamata, engineStarting è vero e get_status segnala quando è attivo. Non fa nulla se il motore è già in esecuzione, e non lo installa mai se manca (connector 0.3.0 o successivo). |
stop_engine | Arresta il motore locale e libera la sua VRAM. La generazione cloud non è interessata (connector 0.3.0 o successivo). |
restart_engine | Riavvia il motore locale, dopo aver installato o rimosso un nodo personalizzato, o quando è bloccato (connector 0.3.0 o successivo). |
list_projects | Elenca i progetti (i contenitori che contengono le generazioni). |
create_project | Crea un nuovo progetto. |
upload_file | Carica un'immagine o video locale e ottieni un handle da passare a generate. |
list_loras | Elenca i LoRA utente installati (nome, modello base, parole trigger) in modo da poterli passare a generate. |
generate | Avvia una generazione di immagine o video. Scegli local, cloud, o auto. Opzionalmente passa loras: [{ name, weight }] (backend locale, preset dove inputs.supportsLoras è true; usa list_loras per i nomi) e un negativePrompt. options accetta i campi denominati (steps, cfg, seed, resolution, aspectRatio, durationSeconds) e qualsiasi Advanced Control che il preset dichiara sotto list_capabilities → options.controls, come unlock, shift o high_steps, come chiave di livello superiore (connector 0.2.0 o successivo). Restituisce un id del lavoro. |
get_job | Ottieni lo stato e il risultato di un lavoro, includendo il percorso di output una volta terminato. |
wait_for_result | Attendi finché un lavoro non finisca, fallisca, o scada il timeout. |
list_jobs | Elenca i recenti lavori di generazione. |
cancel_job | Annulla un lavoro in coda o in esecuzione. |
prepare_preset | Avvia il download dei modelli di un preset locale in modo che diventi pronto per l'esecuzione. |
get_result_image | Restituisce l'immagine di un lavoro terminato inline per la visualizzazione. I risultati video restituiscono un percorso di file. |
list_recipe_blocks | Elenca i blocchi costitutivi per l'authoring di una ricetta: punti di ingresso (crea immagine o video, modifica immagine, upscale) e ogni preset utilizzabile come step, ognuno con il suo contratto di porta (input di cui ha bisogno, cosa produce, quali punti di ingresso si adattano). |
compose_recipe | Autore una nuova ricetta da una specifica di alto livello (step ordinati ancorati ai preset, più qualsiasi input) e salvala come bozza. SimpliGen auto-connette le porte, la catena di media step-to-step, e un input di prompt per step, quindi convalida. Restituisce l'id della ricetta più la convalida. |
validate_recipe | Esegui una specifica di ricetta (o una config non elaborata) senza salvare, e ottieni errori precisi da correggere prima di comporre. |
list_recipes | Elenca le bozze di ricetta salvate su questo dispositivo. |
get_recipe | Ottieni una ricetta salvata e la sua config completa per id. |
publish_recipe | Invia una ricetta salvata al Creator Marketplace (in coda per revisione umana). Necessita un account connesso; pubblica gratuitamente a meno che non sia impostato un prezzo token una tantum. |
run_recipe | Esegui una ricetta installata (quelle in UGC Studio e Product Studio, o una bozza) con i suoi input compilati. Un input di subject accetta un id di carattere o prodotto, gli input di media accettano handle di upload, gli input di testo e scelta accettano valori semplici. Stessa pipeline che fare clic su Generate nello studio. Restituisce un id di esecuzione. |
get_recipe_run | Stato di un'esecuzione di ricetta: stato generale, ogni step con il suo stato e risultato, e il percorso del risultato finale una volta terminato. |
wait_for_recipe_run | Blocca finché un'esecuzione di ricetta non finisca (o un timeout passa) e restituisce l'esecuzione finale. |
list_recipe_runs | Esecuzioni recenti di una ricetta con il loro stato e risultati. |
cancel_recipe_run | Interrompi un'esecuzione di ricetta. Nessun ulteriore step inizia; uno step locale in volo viene interrotto. |
list_subjects | Ogni subject che un input subject di ricetta può accettare: caratteri e prodotti, con i loro id. |
list_products | I prodotti salvati su questo dispositivo. |
create_product | Salva un prodotto da una foto caricata (nome, descrizione, categoria) in modo che Product Studio e le ricette UGC possono usarlo. Restituisce l'id del prodotto. |
remove_product | Elimina un prodotto e la sua foto. |
list_characters | Elenca tutti i caratteri attivi in Character Studio. |
get_character | Ottieni i dettagli e le immagini per un singolo carattere per id. |
list_character_features | Elenca tutte le funzionalità di identità (tono della pelle, capelli, ecc.) e le loro opzioni, per l'uso quando si crea un carattere per descrizione. |
list_character_presets | Elenca i preset installati disponibili per ogni ruolo di carattere: generazione di ritratto base, editing di identità, animazione da immagine a video, e miglioramento (upscale). Ogni preset di miglioramento include un array supportedScales. |
create_character | Crea un nuovo carattere. Supporta tre percorsi: describe (genera un ritratto base dalle selezioni di funzionalità), upload (usa la tua immagine come base), e vision-recreate (funzionalità descritte da agente da una foto utente). In modalità generate, lo strumento esegue il polling internamente finché il ritratto base non è pronto e restituisce l'oggetto carattere pronto. In modalità upload, il carattere è pronto immediatamente. |
generate_character_image | Genera un'immagine di scena per un carattere esistente per prompt. Accetta un presetId opzionale per selezionare quale preset di identity-edit usare per questa chiamata. Restituisce uno o più id di lavoro da eseguire il polling via wait_for_result. |
generate_character_video | Genera un video animato per un carattere esistente. Accetta opzionale framePresetId (preset di identity-edit per lo step di frame) e videoPresetId (preset i2v per lo step di animazione). Restituisce id di lavoro sia per lo step di frame che per lo step di animazione. |
generate_character_frame | Genera un singolo fotogramma fermo per un carattere senza animarlo. Utile quando vuoi rivedere o migliorare il fotogramma prima di animarlo. Accetta un presetId opzionale. Restituisce { jobIds: [...] }; usa jobIds[0] come id del lavoro di frame. |
animate_character | Anima un carattere da un fotogramma completato o da qualsiasi lavoro di immagine completato. Passa jobId (un id di lavoro da qualsiasi generazione completata) o un filePath (percorso di immagine locale assoluto). Accetta un opzionale videoPresetId. Restituisce un id di lavoro video. |
set_character_preset | Imposta un preset predefinito appiccicoso per carattere per la generazione di immagini (imagePresetId) e/o la generazione di video (videoPresetId). Passa null per cancellare un predefinito. Le chiamate successive a generate_character_image e generate_character_video usano questi predefiniti a meno che non vengono sovrascritti per-call. |
enhance_character_media | Upscale o migliora un'immagine o video di carattere. La fonte può essere un lavoro completato (jobId), un file caricato (handle filePath), o il ritratto base del carattere (target: 'base'). Accetta scale (fattore di upscale), keepResolution (upscale quindi ridimensiona indietro alle dimensioni di origine per un risultato di stessa dimensione più nitido), e applyAsBase (sostituisci il ritratto base del carattere con il risultato upscalato). Restituisce un id di lavoro. |
regenerate_character_base | Rigenera il ritratto base per un carattere esistente in sede, opzionalmente passando a un preset base diverso o aggiornando l'identità. Nessun nuovo carattere viene creato. Esegue il polling internamente, accetta automaticamente la nuova base, e restituisce l'oggetto carattere pronto. L'agente non ha bisogno di eseguire il polling di un id di lavoro in seguito. |
remove_character | Elimina in modo permanente un carattere e i suoi dati associati. |
Come si connette
L'agente esegue il server MCP con npx -y @simpligen/mcp su stdio. Il server si autentica all'app con un token di accoppiamento (SIMPLIGEN_TOKEN) e trova la porta locale dell'app automaticamente. L'app SimpliGen deve essere in esecuzione. Crea un token in Impostazioni, nella sezione "Connetti un agente".
Stai creando un'integrazione personalizzata?
Gli strumenti MCP inoltrano a un'API Control HTTP locale che puoi chiamare direttamente da qualsiasi linguaggio. Vedi il riferimento API Control.
Limiti di spesa
Ogni token può avere un limite di spesa. Un limite vuoto significa uso cloud illimitato, 0 significa solo generazione locale, e un numero positivo limita la spesa cloud a quel numero di crediti. La generazione locale è sempre consentita e non conta mai contro il limite.