相片庫

scan_directory

把一個照片資料夾掃描進 imagic 圖庫。

功能

請在選片、編輯或匯出之前,先使用這個:尚未匯入的照片,其他工具都無法處理。請提供一個裝有 RAW 或 JPEG/PNG/TIFF 檔案的資料夾的絕對路徑,子資料夾也會一併包含。重複掃描是安全的;已知的檔案會被略過。回傳已發現、新匯入和略過的檔案數量。在遠端連線上,面對大容量記憶卡這可能要花上幾分鐘:超過一小段時間預算後,它會回傳 {"status": "running", "job_id": ...},這時請用該 job_id 呼叫 get_job_status 持續查看,準備好後就會得到上面所示的同一份結果。本機用戶端永遠直接取得結果。

參數

名稱類型必填
path str 必填

如何要求

你不需要指名呼叫它。你說出想要的,代理會挑選工具:

替 D:/Shoots/eva_tom 裡的婚禮拍攝選片,留下最好的畫面,並告訴我你丟掉了哪些。

其餘的 相片庫 工具

get_library_stats list_photos get_photo get_preview_url get_job_status

會用到它的工作流程

在哪裡執行

在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序;照片絕不會離開你的磁碟,也不會上傳任何東西。參考文件中的每個工具都是如此,包括這一個。

要呼叫它,你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。

把整條流程交給你的 AI

scan_directory 是 imagic Max 中 30 個工具之一。500 次匯出的免費試用包含全部工具。