이미지 생성기 MCP 서버

Replicate를 사용하여 이미지를 생성하고 사용자가 이를 저장할 수 있는 MCP 서버입니다.

구성 요소

자원

서버는 다음을 사용하여 이미지 저장 시스템을 구현합니다.

• 개별적으로 생성된 이미지에 액세스하기 위한 사용자 정의 image:// URI 체계

• 각 이미지 리소스에는 프롬프트, 생성 날짜가 포함된 설명, 이미지/png mimetype을 기반으로 하는 이름이 있습니다.

프롬프트

서버는 단일 프롬프트를 제공합니다.

• generate-image: Stable Diffusion을 사용하여 이미지를 생성하기 위한 프롬프트를 생성합니다.

  • 이미지 스타일(사실적/예술적/추상적)을 제어하기 위한 선택적 "스타일" 인수

  • 스타일별 지침이 포함된 프롬프트 템플릿을 생성합니다.

도구

서버는 세 가지 도구를 구현합니다.

• generate-image: Replicate의 Stable Diffusion 모델을 사용하여 이미지를 생성합니다.

  • "prompt"를 필수 문자열 인수로 사용합니다.

  • 선택 매개변수에는 "negative_prompt", "width", "height", "num_inference_steps" 및 "guidance_scale"이 포함됩니다.

  • 생성된 이미지와 해당 URL을 반환합니다.

• save-image: 생성된 이미지를 로컬 파일 시스템에 저장합니다.

  • 필수 문자열 인수로 "image_url" 및 "prompt"를 사용합니다.

  • 이미지에 대한 고유 ID를 생성하고 "generated_images" 디렉토리에 저장합니다.

• list-saved-images: 저장된 모든 이미지를 나열합니다.

  • 메타데이터와 썸네일이 포함된 모든 저장된 이미지 목록을 반환합니다.

Related MCP server: MCP Server for Replicate

구성

API 토큰 복제

이 이미지 생성기를 사용하려면 Replicate API 토큰이 필요합니다.

1. Replicate 에서 계정을 만드세요

2. https://replicate.com/account 에서 API 토큰을 받으세요.

3. 제공된 .env.example 템플릿을 기반으로 .env 파일을 만듭니다.

지엑스피1

중요: API 토큰이 실수로 노출되는 것을 방지하기 위해 .env 파일은 .gitignore 를 통해 버전 관리에서 제외됩니다. 민감한 정보는 저장소에 커밋하지 마세요.

환경 설정

1. 저장소를 복제합니다.

git clone https://github.com/yourusername/image-generator.git
cd image-generator

2. 가상 환경을 만들고 활성화하세요.

# Using venv
python -m venv .venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate

3. 종속성 설치:

pip install -r requirements.txt

4. 위에 설명한 대로 .env 파일을 설정하세요.

빠른 시작

설치하다

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

용법

서버가 실행되면 다음을 수행할 수 있습니다.

1. 설명적 프롬프트와 함께 "generate-image" 도구를 사용하여 이미지를 생성합니다.

2. 이미지 URL과 프롬프트를 사용하여 "save-image" 도구를 사용하여 생성된 이미지를 저장합니다.

3. "list-saved-images" 도구를 사용하여 저장된 모든 이미지를 확인하세요.

4. 리소스 목록을 통해 저장된 이미지에 접근

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

uv sync

2. 패키지 배포 빌드:

uv build

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

uv publish

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN

• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory B:\NEWTEST\image-generator run image-generator

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.