이미지 생성 MCP 서버

이 MCP 서버는 Replicate Flux 모델을 사용하여 이미지 생성 기능을 제공합니다.

설치

옵션 1: NPX 방식(로컬 설정 필요 없음)

로컬에 설치하지 않고도 npm에서 바로 패키지를 사용할 수 있습니다.

지엑스피1

옵션 2: 로컬 설치

로컬 설치를 선호하는 경우:

# Global installation
npm install -g @gongrzhe/image-gen-server

# Or local installation
npm install @gongrzhe/image-gen-server

설정

Claude Desktop 구성

Claude Desktop 구성 파일을 편집하세요.

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

옵션 1: NPX 구성(권장)

이 방법은 로컬 파일이 필요 없이 npm에서 직접 서버를 실행합니다.

{
  "mcpServers": {
    "image-gen": {
      "command": "npx",
      "args": ["@gongrzhe/image-gen-server"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

옵션 2: 로컬 설치 구성

패키지를 로컬로 설치한 경우:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen-server/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token",
        "MODEL": "alternative-model-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

복제 API 토큰 받기

https://replicate.com 에서 가입/로그인하세요
https://replicate.com/account/api-tokens 로 이동하세요
새로운 API 토큰을 생성하세요
토큰을 복사하고 MCP 설정에서 your-replicate-api-token 교체하세요.

환경 변수

REPLICATE_API_TOKEN (필수): 인증을 위한 Replicate API 토큰
MODEL (선택 사항): 이미지 생성에 사용할 Replicate 모델입니다. 기본값은 "black-forest-labs/flux-schnell"입니다.

구성 매개변수

disabled : 서버가 활성화( false )되어 있는지 또는 비활성화( true )되어 있는지 제어합니다.
autoApprove : 사용자 확인 없이 실행할 수 있는 도구 이름 배열입니다. 배열이 비어 있으면 모든 도구 호출에 확인이 필요합니다.

사용 가능한 도구

생성_이미지

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

매개변수

prompt (필수): 생성할 이미지에 대한 텍스트 설명
seed (선택 사항): 재현 가능한 생성을 위한 무작위 시드
aspect_ratio (선택 사항): 이미지 종횡비(기본값: "1:1")
output_format (선택 사항): 출력 형식 - "webp", "jpg" 또는 "png"(기본값: "webp")
num_outputs (선택 사항): 생성할 이미지 수(1-4, 기본값: 1)

사용 예

const result = await use_mcp_tool({
  server_name: "image-gen",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "16:9",
    output_format: "png",
    num_outputs: 1
  }
});

이 도구는 생성된 이미지에 대한 URL 배열을 반환합니다.

📜 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.