이미지 생성기 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 토큰이 필요합니다.
Replicate 에서 계정을 만드세요
https://replicate.com/account 에서 API 토큰을 받으세요.
제공된
.env.example템플릿을 기반으로.env파일을 만듭니다.
지엑스피1
중요: API 토큰이 실수로 노출되는 것을 방지하기 위해
.env파일은.gitignore를 통해 버전 관리에서 제외됩니다. 민감한 정보는 저장소에 커밋하지 마세요.
환경 설정
저장소를 복제합니다.
가상 환경을 만들고 활성화하세요.
종속성 설치:
위에 설명한 대로
.env파일을 설정하세요.
빠른 시작
설치하다
클로드 데스크탑
MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json
용법
서버가 실행되면 다음을 수행할 수 있습니다.
설명적 프롬프트와 함께 "generate-image" 도구를 사용하여 이미지를 생성합니다.
이미지 URL과 프롬프트를 사용하여 "save-image" 도구를 사용하여 생성된 이미지를 저장합니다.
"list-saved-images" 도구를 사용하여 저장된 모든 이미지를 확인하세요.
리소스 목록을 통해 저장된 이미지에 접근
개발
건축 및 출판
배포를 위해 패키지를 준비하려면:
종속성 동기화 및 잠금 파일 업데이트:
패키지 배포 빌드:
이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.
PyPI에 게시:
참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.
토큰:
--token또는UV_PUBLISH_TOKEN또는 사용자 이름/비밀번호:
--username/UV_PUBLISH_USERNAME및--password/UV_PUBLISH_PASSWORD
디버깅
MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.
다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.
Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.