open-index/open-npm huggingface dataset:
npm package: @sions/imagesearch-mcp
Description: MCP server for image search and download from Civitai and Iconify
Author: mrsions
Latest version: 0.1.0

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

# ImageSearch MCP

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

## 주요 기능

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

## 주의사항
- 이 프로젝트는 node v22.18.0에서 제작됐습니다.

## 설치 방법

### claude-code
```bash
claude mcp add -s user imagesearch-mcp npx -y @sions/imagesearch-mcp
```

### gemini-cli
```bash
gemini mcp add -s user imagesearch-mcp 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. 연구/학습 목적 준수

---

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