A
security-
licenseA
qualityA Model Context Protocol server that provides image generation capabilities using the Ideogram API, allowing users to create images from text prompts with customizable parameters.
Last updated -
1
5
이미지 생성 MCP 서버
Replicate의 black-forest-labs/flux-schnell 모델을 사용하여 이미지를 생성하기 위한 MCP(Model Context Protocol) 서버 구현입니다.
이상적으로는 Cursor의 MCP 기능과 함께 사용하는 것이 좋지만, 모든 MCP 클라이언트와 함께 사용할 수 있습니다.
특징
텍스트 프롬프트에서 이미지 생성
구성 가능한 이미지 매개변수(해상도, 종횡비, 품질)
생성된 이미지를 지정된 디렉토리에 저장합니다.
전체 MCP 프로토콜 준수
오류 처리 및 검증
필수 조건
노드.js 16+
API 토큰 복제
MCP용 TypeScript SDK
설정
저장소를 복제합니다
종속성 설치:
지엑스피1
apiToken상수를 업데이트하여src/imageService.ts의 코드에 Replicate API 토큰을 직접 추가합니다.// No environment variables are used since they can't be easily set in cursor const apiToken = "your-replicate-api-token-here";참고: Claude와 함께 사용하는 경우 루트 디렉토리에
.env파일을 만들고 거기에 API 토큰을 설정할 수 있습니다.REPLICATE_API_TOKEN=your-replicate-api-token-here그런 다음 프로젝트를 빌드합니다.
npm run build
용법
커서와 함께 사용하려면:
설정으로 이동
기능 선택
"MCP 서버"까지 아래로 스크롤하세요.
"새 MCP 서버 추가"를 클릭하세요.
유형을 "명령"으로 설정하세요
명령을 다음으로 설정하세요:
node ./path/to/dist/server.js
API 매개변수
매개변수 | 유형 | 필수의 | 기본 | 설명 |
| 끈 | 예 | - | 이미지 생성을 위한 텍스트 프롬프트 |
| 끈 | 예 | - | 생성된 이미지를 저장할 서버 디렉토리 경로 |
| 부울 | 아니요 | 거짓 | 더 빠른 생성 모드 활성화 |
| 끈 | 아니요 | "1" | 해상도 품질("1", "2", "4") |
| 숫자 | 아니요 | 1 | 생성할 이미지 수(1-4) |
| 끈 | 아니요 | "1:1" | 종횡비("1:1", "4:3", "16:9") |
| 끈 | 아니요 | "웹피" | 이미지 형식("webp", "png", "jpeg") |
| 숫자 | 아니요 | 80 | 압축 품질(1-100) |
| 숫자 | 아니요 | 4 | 노이즈 제거 단계 수(4-20) |
예제 요청
{
"prompt": "black forest gateau cake spelling out 'FLUX SCHNELL'",
"output_dir": "/var/output/images",
"filename": "black_forest_cake",
"output_format": "webp"
"go_fast": true,
"megapixels": "1",
"num_outputs": 2,
"aspect_ratio": "1:1"
}
예시 응답
{
"image_paths": [
"/var/output/images/output_0.webp",
"/var/output/images/output_1.webp"
],
"metadata": {
"model": "black-forest-labs/flux-schnell",
"inference_time_ms": 2847
}
}
오류 처리
서버는 다음과 같은 오류 유형을 처리합니다.
검증 오류(잘못된 매개변수)
API 오류(API 문제 복제)
서버 오류(파일 시스템, 권한)
알 수 없는 오류(예상치 못한 문제)
각 오류 응답에는 다음이 포함됩니다.
오류 코드
사람이 읽을 수 있는 메시지
자세한 오류 정보
특허
아이에스씨
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
구성 가능한 매개변수와 완전한 MCP 프로토콜 준수를 통해 사용자가 Replicate 모델을 사용하여 텍스트 프롬프트에서 이미지를 생성할 수 있습니다.
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA MCP server that enables Claude and other MCP-compatible assistants to generate images from text prompts using Together AI's image generation models.Last updated -4MIT License
- -security-license-qualityProvides image generation capabilities using the Flux Schnell model on Replicate, allowing users to create images from text prompts.Last updated -1MIT License
- -security-license-qualityProvides image generation capabilities for Claude using the Replicate Flux model, allowing users to create images from text prompts with customizable parameters like aspect ratio and output format.Last updated -3840MIT License