플럭스 이미지 MCP 서버

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

설치

1. MCP SDK를 전역적으로 설치합니다.

지엑스피1

1. 이 저장소를 MCP 서버 디렉토리에 복제하세요.

cd ~/Documents/Cline/MCP
git clone https://github.com/yourusername/flux-img-mcp.git
cd flux-img-mcp
npm install

2. 서버를 빌드하세요:

npm run build

3. MCP 설정 파일(전역 또는 작업 공간)에 서버 구성을 추가합니다.

{
  "mcpServers": {
    "flux-img": {
      "command": "node",
      "args": ["/path/to/flux-img-mcp/build/index.js"],
      "env": {
        "REPLICATE_API_TOKEN": "your-replicate-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Related MCP server: Flux Schnell MCP Server

구성

서버에는 다음 환경 변수가 필요합니다.

• REPLICATE_API_TOKEN : Replicate API 토큰입니다. Replicate 계정 설정 에서 확인할 수 있습니다.

용법

설치 및 구성이 완료되면 서버는 다음 도구를 제공합니다.

생성_이미지

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

매개변수:

• prompt (문자열, 필수): 원하는 이미지에 대한 텍스트 설명

사용 예:

<use_mcp_tool>
<server_name>flux-img</server_name>
<tool_name>generate_image</tool_name>
<arguments>
{
  "prompt": "A beautiful sunset over mountains"
}
</arguments>
</use_mcp_tool>

이 도구는 다음을 포함하는 JSON 응답을 반환합니다.

• status : 생성 요청의 상태

• output : 생성된 이미지의 URL(성공 시)

• error : 실패한 경우의 오류 메시지

개발

서버를 변경하려면:

1. src/index.ts 의 소스 코드를 수정하세요.

2. 서버를 다시 빌드하세요: npm run build

3. 변경 사항을 적용하려면 MCP 서버를 다시 시작하세요.

오류 처리

서버에는 다음에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• API 토큰이 없습니다

• 잘못된 매개변수

• API 요청 실패

• 네트워크 문제

보안

• Replicate API 토큰을 버전 제어에 커밋하지 마십시오.

• 항상 환경 변수를 통해 토큰을 제공하세요

• 서버는 API 요청을 하기 전에 모든 입력 매개변수를 검증합니다.