功能
name 依檔名尋找照片，就像人們稱呼它們的方式（「DSC04851」）：不分大小寫，可比對名稱的一部分，也可以一次接受多個以逗號分隔的名稱。用它把使用者提到的名稱，轉成其他每個工具所需要的照片 id。taken 是照片拍攝的時間（來自 EXIF 的 ISO 時間）：在沒有描述的情況下，可用它依日或依傍晚（「日落的那些畫面」）把一場拍攝分組。taken_after / taken_before 依它篩選（ISO 格式，含邊界；只寫日期就涵蓋整天），例如 status="keep", taken_after="2026-09-22T18:00"：在大型拍攝中，請篩選而不是列出全部。拍攝時間由 analyze_photos 讀取，所以依時間篩選之前請先執行它；在那之前，回應中的 note 會說明有多少照片還沒有時間。依狀態（pending、keep、trash、culled、exported、error）篩選，或省略它以取得全部。用 limit 和 offset 翻頁瀏覽大型圖庫；回應會包含符合的總數。這份清單中的照片 id，就是每個針對單張照片的工具所需要的。
參數
| 名稱 | 類型 | 必填 |
|---|---|---|
status |
str | None |
選填 |
limit |
int |
選填 |
offset |
int |
選填 |
taken_after |
str | None |
選填 |
taken_before |
str | None |
選填 |
name |
str | None |
選填 |
如何要求
你不需要指名呼叫它。你說出想要的，代理會挑選工具：
替 D:/Shoots/eva_tom 裡的婚禮拍攝選片，留下最好的畫面，並告訴我你丟掉了哪些。
其餘的 相片庫 工具
會用到它的工作流程
- 用 AI 替婚禮拍攝選片 — AI 婚禮照片選片
- 挑選並匯出客戶相簿 — AI 挑選最佳照片 客戶相簿
- 找出重複與近似重複的照片 — 自動找出重複照片
- 自動評分並排序照片 — 自動照片品質評分
在哪裡執行
在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序；照片絕不會離開你的磁碟，也不會上傳任何東西。參考文件中的每個工具都是如此，包括這一個。
要呼叫它，你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。