mrsions/ImageSearch-MCP

이 프로젝트는 비공식적인 크롤링 기반 버전입니다. 연구 및 학습 목적으로만 사용하시기 바랍니다.
상업적 용도나 대량의 요청은 금지되며, 관련 서비스의 이용약관을 준수해 주세요.

ImageSearch MCP

Claude용 이미지 검색 및 다운로드 MCP(Model Context Protocol) 서버입니다. Civitai에서 AI 생성 이미지를, Iconify에서 아이콘을 검색하고 다운로드할 수 있습니다.

주요 기능

• ** AI 이미지 검색**: Civitai에서 AI 생성 이미지 검색 (그림, 배경, 인물 등)
• ** 아이콘 검색**: Iconify에서 벡터 아이콘 검색
• ** 이미지 다운로드**: URL에서 이미지를 다운로드하고 크기 조정, 형식 변환
• ** ES Modules**: 최신 JavaScript 모듈 시스템 사용

주의사항

• 이 프로젝트는 node v22.18.0에서 제작됐습니다.

설치 방법

claude-code

claude mcp add -s user imagesearch-mcp npx -y @sions/imagesearch-mcp

or 

claude mcp add -s user imagesearch-mcp cmd /c npx -y @sions/imagesearch-mcp

gemini-cli

gemini mcp add -s user imagesearch-mcp npx -y @sions/imagesearch-mcp

or

gemini mcp add -s user imagesearch-mcp cmd /c npx -y @sions/imagesearch-mcp

제공하는 도구

1. search_image - 통합 이미지 검색

다양한 종류의 이미지를 검색하는 통합 도구입니다.

매개변수

• type (필수): 이미지 분류
  • icon: Iconify에서 아이콘 검색
  • picture: Civitai에서 일반 그림 검색
  • background: Civitai에서 배경 이미지 검색
  • portrait: Civitai에서 인물 사진 검색
• query (필수): 검색 키워드 또는 프롬프트 (공백으로 단어 구분)

2. download_image - 이미지 다운로드 및 처리

지정된 URL에서 이미지를 다운로드하고 다양한 처리를 수행하는 도구입니다.

매개변수

• url (필수): 다운로드할 이미지 URL
• path (필수): 저장할 로컬 파일 경로 (예: images/my_image.png)
• width (선택): 이미지 너비 (픽셀)
• height (선택): 이미지 높이 (픽셀)
• color (선택): 배경색 (Iconify SVG만 해당, 예: red, #FFFFFF)

주요 기능

• 자동 디렉토리 생성: 지정된 경로의 폴더가 없으면 자동 생성
• 이미지 리사이징: Sharp를 이용한 고품질 크기 조정
• SVG → 래스터 변환: SVG를 PNG/JPG로 자동 변환
• URL 최적화:
  • Iconify: width, height, color 파라미터 자동 추가
  • Civitai: width 파라미터로 해상도 조정
• 파일 크기 제한: 최대 10MB (보안상 제한)

라이선스

Apache-2.0

기여하기

이슈 리포트나 풀 리퀘스트를 환영합니다. 기여하기 전에 다음을 확인해 주세요:

1. 코드 스타일 준수
2. 테스트 통과 확인
3. 연구/학습 목적 준수

면책 조항: 이 도구는 교육적 목적으로만 제작되었습니다. 사용자는 관련 서비스의 이용약관과 로봇 배제 표준을 준수할 책임이 있습니다.