플럭스 MCP 복제

Replicate Flux MCP는 AI 어시스턴트가 고품질 이미지와 벡터 그래픽을 생성할 수 있도록 지원하는 고급 모델 컨텍스트 프로토콜(MCP) 서버입니다. Replicate API를 통해 래스터 이미지에는 Black Forest Labs의 Flux Schnell 모델을 , 벡터 그래픽에는 Recraft의 V3 SVG 모델을 활용합니다.

📑 목차

시작하기 및 통합
특징
선적 서류 비치
- 사용 가능한 도구
- 사용 가능한 리소스
개발
기술적 세부 사항
문제 해결
기여하다
특허
자원
예시

🚀 시작하기 및 통합

설정 프로세스

복제 API 토큰 얻기
- Replicate 에 가입하세요
- 계정 설정에서 API 토큰을 생성하세요
통합 방법을 선택하세요
- 선호하는 MCP 클라이언트에 따라 아래 통합 옵션 중 하나를 따르세요.
AI 비서에게 이미지 생성을 요청하세요
- 자연스럽게 물어보세요. "일몰 때의 고요한 산 풍경 이미지를 만들어낼 수 있나요?"
- 또는 더 구체적으로 "전경에 일몰 색상을 반사하는 호수가 있는 평화로운 산 풍경을 보여주는 이미지를 만들어 주세요"라고 말씀해 주세요.
고급 기능 살펴보기
- 사용자 정의 결과를 위해 다양한 매개변수 설정을 시도해 보세요.
- generate_svg 사용하여 SVG 생성을 실험해 보세요
- 일괄 이미지 생성 또는 변형 생성 기능 사용

커서 통합

방법 1: mcp.json 사용

프로젝트 디렉토리에서 .cursor/mcp.json 파일을 만들거나 편집하세요.

지엑스피1

YOUR_TOKEN 실제 Replicate API 토큰으로 바꾸세요.
변경 사항을 적용하려면 커서를 다시 시작하세요.

방법 2: 수동 모드

커서를 열고 설정으로 이동하세요
"MCP" 또는 "모델 컨텍스트 프로토콜" 섹션으로 이동합니다.
"서버 추가" 또는 이와 동등한 것을 클릭하세요.
해당 필드에 다음 명령을 입력하세요.

env REPLICATE_API_TOKEN=YOUR_TOKEN npx -y replicate-flux-mcp

YOUR_TOKEN 실제 Replicate API 토큰으로 바꾸세요.
설정을 저장하고 필요한 경우 커서를 다시 시작하세요.

Claude 데스크톱 통합

구성 디렉토리에서 mcp.json 파일을 만들거나 편집하세요.

{
  "mcpServers": {
    "replicate-flux-mcp": {
      "command": "npx",
      "args": ["-y", "replicate-flux-mcp"],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR TOKEN"
      }
    }
  }
}

YOUR_TOKEN 실제 Replicate API 토큰으로 바꾸세요.
변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

스미서리 통합

이 MCP 서버는 Smithery에서 호스팅 서비스로 제공되므로, 자체 서버를 설정하지 않고도 사용할 수 있습니다.

계정이 없으면 Smithery를 방문하여 계정을 만드세요.
Replicate Flux MCP 서버 페이지 로 이동합니다.
"작업 공간에 추가"를 클릭하여 Smithery 작업 공간에 서버를 추가하세요.
Smithery 작업 공간 URL을 사용하도록 MCP 클라이언트(Cursor, Claude Desktop 등)를 구성하세요.

MCP 클라이언트와 함께 Smithery를 사용하는 방법에 대한 자세한 내용은 Smithery 설명서를 참조하세요.

Glama.ai 통합

이 MCP 서버는 Glama.ai에서 호스팅 서비스로도 제공되므로 로컬 설정 없이 사용할 수 있는 또 다른 옵션을 제공합니다.

Glama.ai를 방문하여 계정이 없으면 계정을 만드세요.
Replicate Flux MCP 서버 페이지 로 이동
작업 공간에 서버를 추가하려면 "서버 설치"를 클릭하세요.
Glama.ai 작업 공간을 사용하도록 MCP 클라이언트를 구성하세요.

자세한 내용은 Glama.ai MCP 서버 설명서를 참조하세요.

🌟 특징

🖼️ 고품질 이미지 생성 - 최첨단 AI 모델인 Flux Schnell을 사용하여 놀라운 이미지를 만들어 보세요.
🎨 벡터 그래픽 지원 - Recraft V3 SVG 모델을 사용하여 전문적인 SVG 벡터 그래픽을 생성합니다.
🤖 AI 어시스턴트 통합 - Claude와 같은 AI 어시스턴트가 시각적 콘텐츠를 생성할 수 있도록 원활하게 지원합니다.
🎛️ 고급 사용자 지정 - 종횡비, 품질, 해상도 등을 제어하여 생성을 미세 조정합니다.
🔌 범용 MCP 호환성 - Cursor, Claude Desktop, Cline, Zed를 포함한 모든 MCP 클라이언트와 호환됩니다.
🔒 안전한 로컬 처리 - 모든 요청은 향상된 개인 정보 보호 및 보안을 위해 로컬에서 처리됩니다.
🔍 포괄적인 역사 관리 - 전체 세대 역사를 추적, 보기 및 검색
📊 일괄 처리 - 단일 요청에서 다양한 프롬프트에서 여러 이미지 생성
🔄 변형 탐색 - 동일한 개념에 대한 다양한 해석을 만들고 비교합니다.
✏️ 프롬프트 엔지니어링 - 전문적인 프롬프트 수정을 통해 이미지 변형을 미세하게 조정합니다.

📚 문서

사용 가능한 도구

`generate_image`

Flux Schnell 모델을 사용하여 텍스트 프롬프트를 기반으로 이미지를 생성합니다.

{
  prompt: string;                // Required: Text description of the image to generate
  seed?: number;                 // Optional: Random seed for reproducible generation
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  num_outputs?: number;          // Optional: Number of images to generate (1-4) (default: 1)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_multiple_images`

Flux Schnell 모델을 사용하여 다양한 프롬프트를 기반으로 여러 이미지를 생성합니다.

{
  prompts: string[];             // Required: Array of text descriptions for images to generate (1-10 prompts)
  seed?: number;                 // Optional: Random seed for reproducible generation
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_image_variants`

단일 프롬프트에서 동일한 이미지의 여러 변형을 생성합니다.

{
  prompt: string;                // Required: Text description for the image to generate variants of
  num_variants: number;          // Required: Number of image variants to generate (2-10, default: 4)
  prompt_variations?: string[];  // Optional: List of prompt modifiers to apply to variants (e.g., ["in watercolor style", "in oil painting style"])
  variation_mode?: "append" | "replace"; // Optional: How to apply variations - 'append' adds to base prompt, 'replace' uses variations directly (default: "append")
  seed?: number;                 // Optional: Base random seed. Each variant will use seed+variant_index
  go_fast?: boolean;             // Optional: Run faster predictions with optimized model (default: true)
  megapixels?: "1" | "0.25";     // Optional: Image resolution (default: "1")
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
  output_format?: string;        // Optional: Output format ("webp", "jpg", "png") (default: "webp")
  output_quality?: number;       // Optional: Image quality (0-100) (default: 80)
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  disable_safety_checker?: boolean; // Optional: Disable safety filter (default: false)
}

`generate_svg`

Recraft V3 SVG 모델을 사용하여 텍스트 프롬프트를 기반으로 SVG 벡터 이미지를 생성합니다.

{
  prompt: string;                // Required: Text description of the SVG to generate
  size?: string;                 // Optional: Size of the generated SVG (default: "1024x1024")
  style?: string;                // Optional: Style of the generated image (default: "any")
                                // Options: "any", "engraving", "line_art", "line_circuit", "linocut"
}

`prediction_list`

Replicate에서 최근 예측 목록을 검색합니다.

{
  limit?: number;  // Optional: Maximum number of predictions to return (1-100) (default: 50)
}

`get_prediction`

특정 예측에 대한 자세한 정보를 얻습니다.

{
  predictionId: string;  // Required: ID of the prediction to retrieve
}

사용 가능한 리소스

`imagelist`

Flux Schnell 모델을 사용하여 생성된 이미지의 기록을 탐색해 보세요.

`svglist`

Recraft V3 SVG 모델로 생성된 SVG 이미지의 기록을 찾아보세요.

`predictionlist`

모든 Replicate 예측 기록을 탐색해 보세요.

💻 개발

저장소를 복제합니다.

git clone https://github.com/yourusername/replicate-flux-mcp.git
cd replicate-flux-mcp

종속성 설치:

npm install

개발 모드 시작:

npm run dev

프로젝트를 빌드하세요:

npm run build

클라이언트에 연결:

{
  "mcpServers": {
    "image-generation-mcp": {
      "command": "npx",
      "args": [
        "/Users/{USERNAME}/{PATH_TO}/replicate-flux-mcp/build/index.js"
      ],
      "env": {
        "REPLICATE_API_TOKEN": "YOUR REPLICATE API TOKEN"
      }
    }
  }
}

⚙️ 기술 세부 사항

스택

모델 컨텍스트 프로토콜 SDK - 도구 및 리소스 관리를 위한 핵심 MCP 기능
API 복제 - 최첨단 AI 이미지 생성 모델에 대한 액세스를 제공합니다.
TypeScript - 유형 안전성을 보장하고 최신 JavaScript 기능을 활용합니다.
Zod - 강력한 API 상호 작용을 위한 런타임 유형 검증을 구현합니다.

구성

src/config/index.ts 에 있는 CONFIG 객체를 수정하여 서버를 구성할 수 있습니다.

const CONFIG = {
  serverName: "replicate-flux-mcp",
  serverVersion: "0.1.2",
  imageModelId: "black-forest-labs/flux-schnell",
  svgModelId: "recraft-ai/recraft-v3-svg",
  pollingAttempts: 25,
  pollingInterval: 2000, // ms
};

🔍 문제 해결

일반적인 문제

인증 오류

REPLICATE_API_TOKEN 이 환경에 올바르게 설정되었는지 확인하세요.
Replicate API로 직접 테스트하여 토큰이 유효한지 확인하세요.

안전 필터 작동됨

이 모델에는 특정 프롬프트를 차단할 수 있는 내장형 안전 필터가 있습니다.
잠재적으로 문제가 될 수 있는 콘텐츠를 피하려면 프롬프트를 수정해 보세요.

시간 초과 오류

더 큰 이미지나 바쁜 서버의 경우 구성에서 pollingAttempts 또는 pollingInterval 늘려야 할 수도 있습니다.
대부분의 사용 사례에서는 기본 설정이 효과적입니다.

🤝 기여하기

참여를 환영합니다! 참여 방법은 다음과 같습니다.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

기능 요청이나 버그 신고는 GitHub 이슈를 생성해 주세요. 이 프로젝트가 마음에 드신다면 저장소에 별표를 표시해 주세요!

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🔗 리소스

🎨 예시

여러 개의 프롬프트	프롬프트 변형

다음은 도구 사용 방법에 대한 몇 가지 예입니다.

`generate_multiple_images` 사용한 일괄 이미지 생성

다양한 프롬프트를 사용하여 여러 개의 고유한 이미지를 한 번에 만듭니다.

{
  "prompts": [
    "A red sports car on a mountain road", 
    "A blue sports car on a beach", 
    "A vintage sports car in a city street"
  ]
}

`generate_image_variants` 사용한 이미지 변형

씨앗을 사용하여 같은 개념에 대한 다양한 해석을 만들어 보세요.

{
  "prompt": "A futuristic city skyline at night",
  "num_variants": 4,
  "seed": 42
}

또는 프롬프트 수정자를 사용하여 스타일 변형을 탐색하세요.

{
  "prompt": "A character portrait",
  "prompt_variations": [
    "in anime style", 
    "in watercolor style", 
    "in oil painting style", 
    "as a 3D render"
  ]
}

Yaroslav Boiko가 ❤️로 만들었습니다

Integrations