list_photos

하는 일

name은 사람들이 사진을 부르는 방식(“DSC04851”)대로 파일 이름으로 사진을 찾아요. 대소문자를 구분하지 않고, 이름의 일부만 맞아도 되며, 쉼표로 구분한 여러 이름을 한꺼번에 받아요. 사용자가 말한 이름을 다른 모든 도구가 요구하는 사진 id로 바꿀 때 쓰세요. taken은 사진을 찍은 시각(EXIF의 ISO 시간)이에요. 설명이 없을 때 촬영분을 날짜나 저녁 시간대별로(“노을 프레임”) 묶는 방법이에요. taken_after / taken_before는 그 시각으로 거르고(ISO, 경계 포함, 날짜만 쓰면 그날 하루 전체), 예를 들면 status="keep", taken_after="2026-09-22T18:00"이에요. 큰 촬영분에서는 전체를 나열하지 말고 걸러서 보세요. 촬영 시각은 analyze_photos가 읽으므로, 시간으로 거르기 전에 먼저 실행하세요. 그 전까지는 응답의 note가 아직 시각이 없는 사진이 몇 장인지 알려 줘요. status(pending, keep, trash, culled, exported, error)로 거르거나, 생략하면 전부 나와요. 큰 라이브러리는 limit과 offset으로 나눠서 넘기세요. 응답에는 전체 일치 개수가 들어 있어요. 이 목록의 사진 id는 사진마다 쓰는 모든 도구가 요구하는 값이에요.

매개변수

요청하는 방법

이 도구를 이름으로 호출하지는 않아요. 원하는 것을 말하면 에이전트가 도구를 골라요:

D:/Shoots/eva_tom의 웨딩 촬영분을 셀렉하고, 가장 좋은 프레임을 남기고, 무엇을 뺐는지 알려 줘.

나머지 라이브러리 도구

이 도구를 쓰는 워크플로

• AI로 웨딩 촬영분 셀렉하기 — AI 웨딩 사진 셀렉
• 고객 갤러리용 사진을 골라 내보내기 — AI로 고객 갤러리에 쓸 가장 좋은 사진 고르기
• 중복 사진과 거의 같은 사진 찾기 — 중복 사진 자동으로 찾기
• 사진에 자동으로 점수 매기고 순위 정하기 — 사진 품질 자동 점수

실행되는 곳

내 컴퓨터에서요. imagic의 MCP 서버는 AI 클라이언트가 시작하는 로컬 프로세스라서, 사진이 디스크 밖으로 나가지 않고 업로드되는 것도 없어요. 이 도구를 포함해 레퍼런스의 모든 도구가 마찬가지예요.

호출하려면 imagic에 연결된 MCP 클라이언트가 필요해요. Claude Code, Cursor, VS Code, Codex, Gemini CLI와 그 밖의 열 개 클라이언트는 설정에 약 삼 분이 걸려요.