Metadata-Version: 2.4
Name: pictora-dave
Version: 0.1.1
Summary: MCP server that lets Claude view, sort, copy, move, and delete image files inside one allowed folder.
Author: Dave Lee
License-Expression: MIT
License-File: LICENSE
Requires-Dist: mcp[cli]>=2.3.0,<3
Requires-Dist: pillow>=13.0.0,<14
Requires-Dist: pydantic>=2.14.3,<3
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# Pictora Image Organizer (pictora-dave)

Claude가 이미지 파일을 직접 보고 폴더별로 정리할 수 있게 해 주는 MCP 서버입니다.

서버를 실행할 때 지정한 **허용 폴더**와 그 안의 하위 폴더에서만 작업합니다.
`../` 등으로 허용 폴더 밖을 가리키는 경로는 모두 거부합니다.
이미지는 확장자(jpg, jpeg, png, gif, bmp, webp, tiff, tif)와 실제 파일 내용을 함께 확인해서 판단합니다.

## 도구

| 도구 | 하는 일 |
| --- | --- |
| `list_image_files` | 폴더 안의 하위 폴더 이름과 이미지 파일 이름, 개수를 알려 줍니다. 하위 폴더 안까지는 찾지 않습니다. |
| `create_directory` | 새 폴더를 만듭니다. `2024/여행`처럼 중간 폴더까지 함께 만들 수 있습니다. |
| `read_image` | 이미지를 열어 Claude가 직접 볼 수 있게 돌려줍니다. 긴 쪽이 1024픽셀보다 크면 줄여서 보내며, 원본은 바꾸지 않습니다. |
| `copy_image` | 이미지를 다른 폴더에 같은 이름으로 복사합니다. 같은 이름의 파일이 있으면 `overwrite`가 true일 때만 덮어씁니다. |
| `move_image` | 이미지를 다른 폴더로 같은 이름으로 옮깁니다. 같은 이름의 파일이 있으면 `overwrite`가 true일 때만 덮어씁니다. |
| `delete_image` | 이미지를 삭제합니다. 삭제 전에 사용자에게 확인 창을 띄우고, 수락한 경우에만 지웁니다. |

## 실행

Python 3.14 이상과 [uv](https://docs.astral.sh/uv/)가 필요합니다. 명령 끝에 허용 폴더 경로를 붙입니다.

```bash
uvx pictora-dave /path/to/images
```

## Claude Code에 연결하기

```bash
claude mcp add pictora -- uvx pictora-dave /path/to/images
```

`/path/to/images`를 정리할 이미지 폴더의 절대 경로로 바꾸세요.
연결한 뒤 Claude Code에서 `/mcp`를 입력하면 연결 상태를 확인할 수 있습니다.

## 라이선스

MIT
