AI Agents
MCP ツール リファレンス
SimpliGen MCP サーバーが AI エージェントに公開するツール、およびその背後にあるローカル Control API。
SimpliGen には MCP サーバー (@simpligen/mcp) が付属しており、AI エージェントをローカルの トークン認証接続を経由して実行中の SimpliGen アプリに接続します。エージェントが MCP ツールを呼び出すと、サーバーはそれらをアプリのローカル Control API に転送します。セットアップについては エージェントを接続する を参照してください。
ツール
| ツール | 機能 |
|---|---|
list_capabilities | エージェントが生成できるすべてのプリセット (画像またはビデオ) をリストアップ。入力とオプション、ローカルで準備完了しているかどうか、クラウド適格性とクレジット コストを含みます。 |
get_status | エンジン状態、クラウドが接続されているかどうか、クレジット残高、アクティブ プロジェクト、characters 機能ブロック (有効化フラグ、base/edit/i2v の インストール済みプリセット数、enhancePresets はインストール済みアップスケール プリセットの数) をレポートします。 |
start_engine | ローカル エンジンがまだ実行されていない場合は開始します。エンジン状態を返します。コールド ブートが呼び出しを超える場合、engineStarting は true となり、get_status は起動時を報告します。エンジンがすでに実行されている場合は何もせず、不足しているものをインストールしません (connector 0.3.0 以降)。 |
stop_engine | ローカル エンジンを停止し、その VRAM を解放します。クラウド生成には影響しません (connector 0.3.0 以降)。 |
restart_engine | ローカル エンジンを再起動します。カスタム ノードのインストールまたは削除後、またはウェッジされた場合 (connector 0.3.0 以降)。 |
list_projects | プロジェクト (生成を保持するコンテナ) をリストアップします。 |
create_project | 新しいプロジェクトを作成します。 |
upload_file | ローカル画像またはビデオをアップロードし、generate に渡すハンドルを取得します。 |
list_loras | インストール済みユーザー LoRA (名前、ベース モデル、トリガー ワード) をリストアップ。generate に渡すために使用できます。 |
generate | 画像またはビデオ生成を開始します。local、cloud、または auto を選択します。オプションで loras: [{ name, weight }] (ローカル バックエンド、inputs.supportsLoras が true であるプリセット; 名前については list_loras を使用) と negativePrompt (追加条件。プリセットのデフォルト ネガティブの後に追加; クラウド実行ではプリセット デフォルトがそのまま使用されます) を渡すことができます。options は命名されたフィールド (steps、cfg、seed、resolution、aspectRatio、durationSeconds) と、プリセットが list_capabilities の下の options.controls で宣言する高度な制御 (unlock、shift、high_steps など) をトップレベル キーとして取ります (connector 0.2.0 以降)。ジョブ ID を返します。 |
get_prompt_guide | プリセット (presetId) の用語ガイドを読む。生成プロンプトを作成する前に読むべき内容: モデルがプロンプトを読む方法、構造、長さ、カメラおよび動きの用語、ネガティブ、キャラクター用語とサンプル。応答は family、generic (モデル固有のガイドが存在しない場合は true) とガイド text を含みます。Connector 0.6.0 以降; generate はエージェントにまずこれを呼び出すよう指示します。 |
get_job | ジョブのステータスと結果を取得。完了後の出力パスを含みます。 |
wait_for_result | ジョブが完了、失敗、またはタイムアウトするまで待機します。 |
list_jobs | 最近の生成ジョブをリストアップします。 |
cancel_job | キューされているまたは実行中のジョブをキャンセルします。 |
prepare_preset | ローカル プリセットのモデル ダウンロードを開始。実行準備完了の状態になります。 |
get_result_image | 完了したジョブの画像をインラインで返して表示します。ビデオ結果はファイル パスを返します。 |
list_recipe_blocks | レシピ作成用のビルディング ブロック: エントリ ポイント (画像またはビデオ作成、画像編集、アップスケール) と、ステップとして使用可能なすべてのプリセット。各項目には、ポート契約 (必要な入力、出力、適合するエントリ ポイント) が含まれます。 |
compose_recipe | 高レベル スペック (プリセットにピンされた順序付きステップ、および入力) からレシピを作成し、ドラフトとして保存します。SimpliGen がポート、ステップ間メディア チェーン、およびステップごとのプロンプト入力を自動配線します。その後検証します。レシピ ID と検証を返します。 |
validate_recipe | レシピ スペック (または生の設定) をドライランし、保存せずに修正する前に正確なエラーを取得します。 |
list_recipes | このデバイスに保存されたレシピ ドラフトをリストアップします。 |
get_recipe | ID でレシピとその完全な設定を取得します。 |
publish_recipe | 保存されたレシピを Creator Marketplace に送信します (人間によるレビューのためキューに登録)。接続されたアカウントが必要です。ワンタイム トークン価格が設定されていない限り、無料で公開されます。 |
run_recipe | インストール済みレシピ (UGC Studio および Product Studio 内のもの、またはドラフト) を入力を埋めて実行します。サブジェクト入力はキャラクター ID または製品 ID を取得、メディア入力はアップロード ハンドルを取得、テキスト入力と選択入力は平文値を取得します。Studio で Generate をクリックする場合と同じパイプライン。実行 ID を返します。 |
get_recipe_run | レシピ実行のステータス: 全体ステータス、各ステップとそのステータスと結果、完了後の最終結果パス。 |
wait_for_recipe_run | レシピ実行が完了するまで (またはタイムアウトが経過するまで) ブロックし、最終実行を返します。 |
list_recipe_runs | レシピの最近の実行をリストアップ。ステータスと結果を含みます。 |
cancel_recipe_run | 実行中のレシピを停止します。それ以上のステップは開始されません。ローカル進行中ステップは中断されます。 |
list_subjects | レシピのサブジェクト入力が取得できるすべてのサブジェクト: キャラクターと製品、その ID 付き。 |
list_products | このデバイスに保存された製品をリストアップします。 |
create_product | アップロードされた写真から製品を保存します (名前、説明、カテゴリ)。Product Studio と UGC レシピが使用できるようにします。製品 ID を返します。 |
remove_product | 製品とその写真を削除します。 |
list_characters | Character Studio のすべてのアクティブ キャラクターをリストアップします。 |
get_character | ID でシングル キャラクターの詳細と画像を取得します。 |
list_character_features | すべてのアイデンティティ フィーチャー (肌色、髪など) とそのオプション。キャラクターを説明で作成するときに使用します。 |
list_character_presets | 各キャラクター ロール用にインストール済みプリセットをリストアップ: ベース ポートレート生成、アイデンティティ編集、画像からビデオへのアニメーション、および拡張 (アップスケール)。各拡張プリセットは supportedScales 配列を含みます。 |
create_character | 新しいキャラクターを作成します。3 つのパスをサポート: describe (フィーチャー選択からベース ポートレートを生成)、upload (独自の画像をベースとして使用)、vision-recreate (エージェント記述フィーチャーをユーザー写真から)。生成モードでは、ツールがベース ポートレートの準備完了まで内部でポーリングし、準備完了のキャラクター オブジェクトを返します。アップロード モードでは、キャラクターはすぐに準備完了です。 |
generate_character_image | 既存のキャラクターのシーン画像をプロンプトで生成します。オプションで presetId を受け入れて、このコール用に使用するアイデンティティ編集プリセットを選択します。1 つ以上のジョブ ID を返します。wait_for_result でポーリングしてください。 |
generate_character_video | 既存のキャラクターのアニメーション ビデオ クリップを生成します。オプションで framePresetId (フレーム ステップ用のアイデンティティ編集プリセット) と videoPresetId (アニメーション ステップ用の i2v プリセット) を受け入れます。フレームとアニメーション ステップ両方のジョブ ID を返します。 |
generate_character_frame | キャラクターのシングル スチル フレームを生成します。アニメーション化しません。フレームをアニメーション化する前に確認または拡張したい場合に便利です。オプションで presetId を受け入れます。{ jobIds: [...] } を返します; フレーム ジョブ ID として jobIds[0] を使用してください。 |
animate_character | 完了したフレームまたはその他の完了した画像ジョブからキャラクターをアニメーション化します。jobId (完了した生成からのジョブ ID) または filePath (絶対パス ローカル画像パス) を渡します。オプションで videoPresetId を受け入れます。ビデオ ジョブ ID を返します。 |
set_character_preset | キャラクターごとのスティッキー デフォルト プリセットを設定します。画像生成 (imagePresetId) またはビデオ生成 (videoPresetId) 用。null を渡してデフォルトをクリアします。その後の generate_character_image と generate_character_video の呼び出しは、呼び出し単位でオーバーライドされない限り、これらのデフォルトを使用します。 |
enhance_character_media | キャラクター画像またはビデオをアップスケールまたは拡張します。ソースは完了したジョブ (jobId)、アップロード済みファイル (filePath ハンドル)、またはキャラクター ベース ポートレート (target: 'base') です。scale (アップスケール係数)、keepResolution (アップスケール後にソース寸法にサイズ変更して、同じサイズで鮮明な結果を得る)、および applyAsBase (アップスケール済み結果でキャラクター ベース ポートレートを置き換える) を受け入れます。ジョブ ID を返します。 |
regenerate_character_base | 既存のキャラクターのベース ポートレートを所定位置で再生成します。オプションで別のベース プリセットに切り替えるか、アイデンティティを更新します。新しいキャラクターは作成されません。内部でポーリングし、新しいベースを自動受け入れして、準備完了のキャラクター オブジェクトを返します。エージェントはその後ジョブ ID をポーリングする必要がありません。 |
remove_character | キャラクターとその関連データを完全に削除します。 |
list_films | プロジェクトの Video Studio フィルムをリストアップします (connector 0.5.0 以降。以下のすべてのフィルム ツールもそうです)。 |
create_film | 空のフィルムを作成します: 形状、解像度、レンダリング場所、ショットの種類ごとのプリセット。タイムラインで回答します。 |
get_film | フィルムのタイムラインを読む: テンポ、キャスト、クリップの番号、秒とバーでの開始と長さ、ショット、テイク ステータス、トラック、マーカー、エクスポート範囲。 |
update_film_settings | フィルムの形状、解像度、レンダリング場所、プリセット、Subject & style、およびすべてのクリップが継承するキャストとロケーションを変更します。 |
add_track | アップロードされたオーディオ ファイルをタイムラインに配置: 歌唱、音楽、ダイアログまたは効果音。 |
move_track | トラックのオーディオを移動、ミュート、またはボリュームを設定します。 |
detect_tempo | 曲からフィルムのテンポとバー ラインを設定します。その後、時間はバーで与えることができます。 |
add_clip | モーメントに空のクリップを追加します。長さを指定します。 |
update_clip | クリップを 1 ステップで書き込む: ショット (プロンプト、長さ、話されたまたは歌われたライン、それを言う者、フレーミング)、キャスト、ロケーション、どのように開始するか (新規または前のクリップから続行; none と frame も受け入れられます。新規と続行として)、どのトラックを聞くか、プリセット。 |
move_clip | クリップを新しい開始または別のビデオ レーンに移動します。 |
trim_clip | クリップの長さ、またはそのテイク内で開始する場所を変更します。 |
remove_clip | クリップを削除します。 |
apply_film_plan | 1 ステップで全体ドラフトをレイアウト: バー上のクリップ。ショット、キャスト、リンク付き。すべての問題が一度に返されます。すべてが有効でない限り、何も変更されません。 |
set_fades | クリップまたはトラックをフェード イン/アウトします。 |
add_marker | ルーラーに命名されたマーカーを配置します。 |
set_export_range | フィルムの一部のみをエクスポート、またはすべてをエクスポートします。 |
render_clips | 必要なクリップ、または命名されたものをレンダリングします。即座に開始されたもの、保留されているもの、クラウド コストで回答します。 |
wait_for_renders | クリップがレンダリング中でなくなるまで待機し、タイムラインで回答します。 |
list_takes | クリップのテイクをリストアップします。 |
use_take | クリップのテイクの 1 つをそれが表示するものにします。 |
export_film | フィルムを 1 つのビデオにステッチしてその音楽を追加し、ファイル パスで回答します。 |
list_locations | Library のロケーションをリストアップします。 |
create_location | アップロードされた画像または完了した画像ジョブからロケーションを保存します。 |
Video Studio でフィルムが開いている場合、エージェントが行うすべての変更は即座に表示され、Ctrl+Z で取り消すことができます。詳細なウォークスルーについては エージェントが音楽ビデオを作成する を参照してください。
接続方法
エージェントは、stdio 経由で npx -y @simpligen/mcp で MCP サーバーを実行します。サーバーはペアリング トークン (SIMPLIGEN_TOKEN) でアプリに認証し、アプリのローカル ポートを自動的に検索します。SimpliGen アプリが実行されている必要があります。設定の「エージェントを接続する」セクションでトークンをミントしてください。
カスタム統合を構築しますか?
MCP ツールはローカル HTTP Control API に転送されます。これは任意の言語から直接呼び出すことができます。Control API リファレンス を参照してください。
支出制限
各トークンには支出キャップを付与できます。空のキャップは無制限クラウド使用を意味し、0 はローカル生成のみを意味し、正の数はクラウド支出をその多くのクレジットでキャップします。ローカル生成は常に許可され、キャップに対してカウントされません。