功能
aspect 是一個比例，例如 "3:1"（全景長條）、"16:9"、"4:5"、"1:1"、"9:16"（限時動態）、"original"，或搭配 box 的 "free"。裁切框是符合畫面的該形狀中最大的一個，再依 size 縮放（1.0 = 盡可能大，0.5 = 寬度減半，也就是更緊的裁切），並以 center_x / center_y 為中心，兩者都是畫面的比例（0 = 左／上，1 = 右／下；會自動微調以保持在畫面內）。如果地平線或主體不在中央，請把 center_y / center_x 往它移動，例如地平線略高於中線，就用 center_y=0.45。box = [x0, y0, x1, y1] 的比例可精確設定裁切（aspect "free"）。clear=true 會移除裁切。它會儲存成編輯器的裁切，所以匯出的檔案會被裁切，編輯器也會顯示相同的畫面。回傳以比例表示的裁切框與結果的尺寸。
參數
| 名稱 | 類型 | 必填 |
|---|---|---|
aspect |
str |
選填 |
photo_id |
int | None |
選填 |
photo_ids |
list[int] | None |
選填 |
center_x |
float |
選填 |
center_y |
float |
選填 |
size |
float |
選填 |
box |
list[float] | None |
選填 |
clear |
bool |
選填 |
如何要求
你不需要指名呼叫它。你說出想要的，代理會挑選工具：
把 imagic 指向我的這場拍攝，告訴我你發現了什麼。
其餘的 編輯 工具
list_presets
apply_preset
list_luts
apply_lut
apply_auto_color
harmonize_series
preview_mosaic
apply_adjustments
mask_adjust
save_preset
export_photos
get_photo_edits
在哪裡執行
在你的電腦上。imagic 的 MCP 伺服器是由你的 AI 用戶端啟動的本機程序；照片絕不會離開你的磁碟，也不會上傳任何東西。參考文件中的每個工具都是如此，包括這一個。
要呼叫它，你需要一個連上 imagic 的 MCP 用戶端。Claude Code、Cursor、VS Code、Codex、Gemini CLI 和其他十個用戶端的設定大約只要三分鐘。