ライブラリ

get_job_status

リモート接続で、別のツールが開始した長時間のジョブの状況を確認します。

内容

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を向けて、何が見つかったか教えてください。

ライブラリのほかのツール

scan_directory get_library_stats list_photos get_photo get_preview_url

実行される場所

お使いのパソコン上です。imagicのMCPサーバーは、AIクライアントが起動するローカルのプロセスで、写真がディスクの外に出ることはなく、何もアップロードされません。これは、このリファレンスにあるすべてのツールに当てはまり、このツールも同じです。

呼び出すには、imagicに接続されたMCPクライアントが必要です。Claude Code、Cursor、VS Code、Codex、Gemini CLIなど十のクライアントで、セットアップは三分ほどです。

AIにパイプライン全体を任せる

get_job_statusは、imagic Maxにある30個のツールの一つです。エクスポート500回の無料トライアルには、そのすべてが含まれます。