MCP 이미지 다운로더 설정 및 사용 매뉴얼

MCP 이미지 다운로더 설정 및 사용 매뉴얼

MCP 이미지 다운로더는 Model Context Protocol(MCP)을 기반으로 구축된 서버로, AI 어시스턴트가 URL에서 이미지를 다운로드하고 기본적인 이미지 최적화 작업(크기 조정, 품질 조정, 포맷 변환)을 수행할 수 있도록 지원합니다. 이 도구는 GitHub 저장소에서 제공되며, 개발자들이 AI 워크플로우에 이미지 처리 기능을 통합하는 데 유용합니다. 이 매뉴얼은 MCP 이미지 다운로더를 설치, 설정, 사용하기 위한 단계별 가이드를 제공합니다.

1. 사전 요구 사항

시작하기 전에 다음 소프트웨어와 환경이 준비되어 있는지 확인하세요:

• Node.js: 버전 16 이상 (nodejs.org에서 다운로드).
• NPM: Node.js에 포함된 패키지 관리자.
• Git: 저장소 복제를 위해 필요 (git-scm.com에서 다운로드).
• MCP 호환 클라이언트: Claude Desktop 또는 MCP를 지원하는 다른 LLM 클라이언트.
• 터미널 기본 지식: 명령어를 실행할 수 있는 기본적인 이해.

2. 설치

MCP 이미지 다운로더를 로컬 환경에 설치하려면 다음 단계를 따르세요:

1. 저장소 복제:
   터미널을 열고 다음 명령어를 실행하여 GitHub 저장소를 복제합니다:
2. git clone https://github.com/qpd-v/mcp-image-downloader.git
3. 프로젝트 디렉토리로 이동:
4. cd mcp-image-downloader
5. 의존성 설치:
   프로젝트에 필요한 Node.js 패키지를 설치합니다:
6. npm install
7. 프로젝트 빌드:
   소스 코드를 실행 가능한 JavaScript 파일로 컴파일합니다:빌드된 파일은 build 디렉토리에 생성됩니다.
8. npm run build

3. 설정

MCP 이미지 다운로더를 MCP 호환 클라이언트(예: Claude Desktop)와 통합하려면 MCP 설정 파일에 서버를 추가해야 합니다.

Claude Desktop 설정

1. 설정 파일 찾기:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. 설정 파일 편집:
   텍스트 에디터로 설정 파일을 열고 다음 내용을 추가합니다:여기서 /절대/경로/mcp-image-downloader/build/index.js는 복제한 저장소의 build 디렉토리에 있는 index.js 파일의 절대 경로로 대체해야 합니다. 예를 들어, 저장소가 /home/user/mcp-image-downloader에 있다면 경로는 /home/user/mcp-image-downloader/build/index.js가 됩니다.
3. { "mcpServers": { "image-downloader": { "command": "node", "args": ["/절대/경로/mcp-image-downloader/build/index.js"] } } }
4. 설정 저장 및 클라이언트 재시작:
   파일을 저장한 후 MCP 클라이언트를 재시작하거나 설정을 새로고침하여 변경 사항을 적용합니다.

다른 MCP 클라이언트

Claude Desktop 이외의 클라이언트를 사용하는 경우, 해당 클라이언트의 문서를 참조하여 MCP 서버를 추가하는 방법을 확인하세요. 일반적으로 설정 파일에 위와 유사한 형식으로 서버 명령어와 인수를 지정합니다.

예를 들어, Cursor와 같은 IDE를 사용하는 경우:

• 전역 설정: ~/.cursor/mcp.json 파일을 편집하여 서버 설정을 추가합니다. Cursor에서 설정 > MCP > "새 전역 MCP 서버 추가"로 이동하여 파일을 편집할 수 있습니다.
• 프로젝트별 설정: 프로젝트 디렉토리에 .cursor/mcp.json 파일을 생성하고 동일한 설정을 추가합니다.
• 설정 후, Cursor의 MCP 설정에서 새로고침 버튼을 클릭하여 변경 사항을 적용합니다.

4. 사용 방법

MCP 이미지 다운로더는 두 가지 주요 도구를 제공합니다:

1. download_image:
   • 설명: 지정된 URL에서 이미지를 다운로드하여 지정된 경로에 저장합니다.
   • 매개변수:
     • url: 다운로드할 이미지의 URL (필수).
     • outputPath: 이미지를 저장할 경로 (필수).
2. optimize_image:
   • 설명: 이미지의 크기, 품질, 포맷을 최적화합니다.
   • 매개변수:
     • inputPath: 입력 이미지의 경로 (필수).
     • outputPath: 최적화된 이미지를 저장할 경로 (필수).
     • width: 원하는 이미지 너비 (선택).
     • height: 원하는 이미지 높이 (선택).
     • quality: JPEG/WebP 이미지의 품질 수준 (1-100, 선택).

이 도구들은 MCP 클라이언트를 통해 AI 어시스턴트가 자동으로 호출합니다. 예를 들어, Claude Desktop에서 이미지 다운로드를 요청하면 AI가 download_image 도구를 사용하여 작업을 수행합니다.

5. 사용 예시

다음은 MCP 이미지 다운로더의 실제 사용 예시입니다:

예시 1: 이미지 다운로드

AI 어시스턴트에게 특정 URL에서 이미지를 다운로드하도록 요청한다고 가정해 봅시다:

• 도구: download_image
• 매개변수:
  • url: https://example.com/sample.jpg
  • outputPath: /path/to/save/sample.jpg
• 결과: AI가 지정된 URL에서 이미지를 다운로드하여 /path/to/save/sample.jpg에 저장합니다.

예시 2: 이미지 최적화

이미지를 크기 조정하고 품질을 낮춰 최적화하려는 경우:

• 도구: optimize_image
• 매개변수:
  • inputPath: /path/to/original/image.jpg
  • outputPath: /path/to/optimized/image.jpg
  • width: 800
  • height: 600
  • quality: 80
• 결과: AI가 원본 이미지를 800x600 픽셀로 크기 조정하고 품질을 80으로 설정하여 최적화된 이미지를 저장합니다.

6. 문제 해결

설치 또는 사용 중 발생할 수 있는 일반적인 문제를 해결하는 방법은 다음과 같습니다:

문제 해결 방법

서버가 시작되지 않음	설정 파일의 index.js 경로가 절대 경로인지, build 디렉토리에 파일이 있는지 확인하세요.
권한 오류	outputPath로 지정된 경로에 쓰기 권한이 있는지 확인하세요.
의존성 오류	npm install을 다시 실행하여 모든 패키지가 설치되었는지 확인하세요.
클라이언트에서 도구를 인식하지 못함	MCP 클라이언트를 재시작하거나 설정을 새로고침하세요.

7. 결론

MCP 이미지 다운로더는 AI 어시스턴트의 이미지 처리 기능을 강화하는 강력한 도구입니다. 이 매뉴얼을 따라 설치, 설정, 사용 방법을 익히면 AI 워크플로우에 이미지 다운로드 및 최적화 기능을 쉽게 통합할 수 있습니다. 이 프로젝트는 qpd-v에 의해 개발되었으며 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

추가 정보 및 업데이트는 GitHub 저장소에서 확인할 수 있습니다. 버그를 발견하거나 기능을 제안하고 싶다면 저장소의 이슈 페이지를 활용하세요.