scan_directory

内容

セレクトや編集、エクスポートの前に、まずこれを使います。取り込まれていない写真には、ほかの操作は一切使えません。RAWまたはJPEG/PNG/TIFFファイルを入れたフォルダーの絶対パスを指定します。サブフォルダーも対象です。再スキャンしても問題なく、すでに把握しているファイルは飛ばされます。見つかったファイル、新しく取り込んだファイル、飛ばしたファイルの数を返します。リモート接続では、大きなカードの場合、これに数分かかることがあります。短い制限時間を過ぎると、代わりに{"status": "running", "job_id": ...}が返ります。そのjob_idを指定してget_job_statusを呼び出して確認を続けると、準備ができたときに、上と同じ結果が得られます。ローカルのクライアントでは、常に結果がそのまま返ります。

パラメーター

頼み方

名前で呼ぶ必要はありません。やりたいことを伝えれば、エージェントがツールを選びます：

D:/Shoots/eva_tomにある結婚式の撮影分をセレクトして、ベストのフレームを残し、外したものを教えてください。

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

このツールを使うワークフロー

• AIで結婚式の撮影分をセレクトする — AIによる結婚式の写真セレクト
• 重複とほぼ重複する写真を見つける — 重複写真を自動で見つける

実行される場所

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

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