Smart Photo Journal MCP Server

📸 스마트 포토 저널 MCP 서버

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

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

🎯 특징

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

🚀 시작하기

필수 조건

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

설치

1. 저장소를 복제합니다.지엑스피1
2. uv 사용하여 종속성을 설치합니다:
   uv sync
3. 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" ] } } }
4. 다음 명령으로 서버를 시작하거나 Claude Desktop을 엽니다.
   uv run server.py

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

MCP 서버 초기화

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

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

🛠️ 사용법

사용 가능한 도구

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

📚 사용 사례 예시

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

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

2. 휴가 하이라이트

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

3. 추억의 재미

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

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

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

⚡ 최상의 결과를 위한 팁

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