内容
scan_directory、analyze_photos、reanalyze_stale_photos、export_photos、learn_style_from_libraryは、それぞれの呼び出しの制限時間内に終わらない場合、リモート接続ではバックグラウンドのジョブとして実行され、{"status": "running", "job_id": ...}を返します。そのjob_idを指定してこれを呼び出し、確認を続けます。ジョブの完了をwait_seconds(上限は30)まで待ってから答えるため、短い呼び出しのループで完了まで追えます。完了すると、元のツールの呼び出しが返したはずのものがそのまま返ります。長いジョブは一度に一つしか実行されず、実行中は、ほかのツールが通常の結果の代わりに{"status": "busy", ...}を返します。ローカル(stdio)のクライアントでも使えますが、長いツールは常に同期的に終わるので、通常は確認するものがありません。
パラメーター
| 名前 | 型 | 必須 |
|---|---|---|
job_id |
str |
必須 |
wait_seconds |
int |
任意 |
頼み方
名前で呼ぶ必要はありません。やりたいことを伝えれば、エージェントがツールを選びます:
私の撮影分にimagicを向けて、何が見つかったか教えてください。
ライブラリのほかのツール
実行される場所
お使いのパソコン上です。imagicのMCPサーバーは、AIクライアントが起動するローカルのプロセスで、写真がディスクの外に出ることはなく、何もアップロードされません。これは、このリファレンスにあるすべてのツールに当てはまり、このツールも同じです。
呼び出すには、imagicに接続されたMCPクライアントが必要です。Claude Code、Cursor、VS Code、Codex、Gemini CLIなど十のクライアントで、セットアップは三分ほどです。
AIにパイプライン全体を任せる
get_job_statusは、imagic Maxにある30個のツールの一つです。エクスポート500回の無料トライアルには、そのすべてが含まれます。