📸 스마트 포토 저널 MCP 서버

스마트 포토 저널은 강력하고 직관적인 도구를 사용하여 사진 라이브러리를 검색하고 분석할 수 있도록 설계된 MCP 서버입니다. 가족과의 추억을 떠올리거나 친구들과 함께 찍은 특정 사진을 찾고 있다면, 이 서버가 정답입니다! 🎉

영감을 얻은 곳: burningion/video-editing-mcp 창의적인 미디어 관리를 위해 MCP를 사용하는 혁신적인 아이디어를 제안한 @burningion 에게 큰 박수를 보냅니다!

🎯 특징

위치 검색: 특정 장소의 사진을 쉽게 찾아보세요. 🌍
라벨 검색: "생일", "해변", "휴가"와 같은 키워드나 라벨로 사진을 검색하세요. 🎉
사람 검색: 특정 사람이 등장하는 사진을 빠르게 찾으세요. 👥
사진 분석: 사진 촬영에 가장 인기 있는 시간과 요일 등 재미있는 정보를 알아보세요. 🕰️
퍼지 매칭: 정확한 이름이 궁금하세요? 걱정하지 마세요! 서버는 유연성을 위해 퍼지 매칭을 지원합니다. 🔍

Related MCP server: file-finder-mcp

🚀 시작하기

필수 조건

사진 라이브러리가 있는 macOS가 있는지 확인하세요.
종속성을 관리하고 서버를 실행하려면 uv를 설치하세요.

설치

저장소를 복제합니다.
지엑스피1
uv 사용하여 종속성을 설치합니다:
```
uv sync
```

MCP 서버를 구성하세요. 다음 구성으로 claude_desktop_config.json 파일을 업데이트하세요.

{
  "mcpServers": {
    "smart-photo-journal": {
      "command": "/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/<PATH_TO_CLONED_DIR>/memory-journal-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

다음 명령으로 서버를 시작하거나 Claude Desktop을 엽니다.
```
uv run server.py
```

참고: <YOUR_DEVICE_USERNAME> 과 <PATH_TO_CLONED_DIR> 실제 기기 사용자 이름과 복제된 디렉터리 경로로 바꾸세요. 서버에 사진 접근 권한을 부여하는 팝업이 표시됩니다. 이 설정은 로컬에서만 적용되며, Claude 서비스 외에는 어떤 사용자와도 데이터가 공유되지 않습니다.

MCP 서버 초기화

서버가 시작되면 다음이 표시됩니다.

Starting Smart Photo Journal MCP server.

이제 사진 문의를 처리할 준비가 되었습니다! 🎉

🛠️ 사용법

사용 가능한 도구

위치 검색
- 설명: 특정 위치에서 촬영한 사진을 찾습니다.
- 입력 예:
  { "location": "Udaipur" }
- 예상 출력:
  Found 5 photos from Udaipur: 📷 IMG_1234.jpg ...
라벨 검색
- 설명: 라벨이나 키워드로 사진을 검색합니다.
- 입력 예:
  { "label": "Birthday" }
- 예상 출력:
  Photos labeled as 'Birthday' (3 found): 📷 IMG_5678.jpg ...
사람 검색
- 설명: 특정 사람이 포함된 사진을 찾습니다.
- 입력 예:
  { "person": "Maa" }
- 예상 출력:
  Photos with Maa (10 found): 📷 IMG_9101.jpg ...
사진 분석
- 설명: 사진 촬영에 가장 많이 사용되는 시간이나 요일 등 사진 라이브러리의 패턴을 분석합니다.
- 입력 예:
  {}
- 예상 출력:
  📸 Photo Taking Patterns: Total Photos: 200 ...

📚 사용 사례 예시

1. 가족 및 친구 앨범 정리기

가족의 소중한 순간을 한곳에 모아보고 싶으신가요? "아빠", "엄마", "친구" 등의 이름으로 people-search 도구를 사용하여 특정 인물의 사진을 찾아보세요.

2. 휴가 하이라이트

location-search 도구를 사용하여 휴가지의 사진을 검색해 보세요.

3. 추억의 재미

지난 생일 사진이 궁금하세요? "생일"로 label-search 하고 그 즐거운 추억을 다시 느껴보세요!

4. 사진 촬영 습관 이해하기

photo-analysis 도구를 사용하여 언제 어디서 사진을 많이 찍는지 파악해 보세요. 이를 바탕으로 다음 촬영 계획을 세워 보세요!

⚡ 최상의 결과를 위한 팁

macOS에 사진 라이브러리가 로드되었는지 확인하세요.
더욱 정확한 결과를 얻으려면 검색어를 최대한 구체적으로 입력하세요.
정확한 이름이 확실하지 않은 경우, 퍼지 매칭을 사용해 유연성을 확보하세요.

Smart Photo Journal MCP Server