플럭스 클라우드플레어 MCP

Cloudflare Worker API를 통해 Black Forest Labs의 Flux 모델을 사용하여 이미지를 생성할 수 있는 기능을 AI 보조자에게 제공하는 강력한 MCP(Model Context Protocol) 서버입니다.

설치 • 기능 • 사용 • 문서 • 기여

🌟 특징

• 🖼️ 고품질 이미지 생성 : 최첨단 이미지 생성 모델인 Flux에 액세스

• 🤖 원활한 AI 통합 : Claude와 같은 AI 도우미가 이미지를 직접 생성할 수 있도록 합니다.

• 🎛️ 사용자 정의 가능한 매개변수 : 종횡비, 추론 단계 등을 제어합니다.

• 🔌 MCP 호환 : 모든 MCP 클라이언트(Cursor, Claude Desktop, Cline, Zed 등)와 호환됩니다.

• 🔒 로컬 처리 : 모든 요청은 Cloudflare Worker를 통해 안전하게 처리됩니다.

• 💬 채팅 완성 : 동일한 API를 사용하여 텍스트 완성을 가져옵니다.

Related MCP server: FLUX Image Generator MCP Server

📦 설치

NPX와 직접 사용

지엑스피1

출처에서

# Clone the repository
git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

# Install dependencies
npm install

# Build the project
npm run build

🚀 Flux API 설정

이 MCP 서버가 작동하려면 Flux API 엔드포인트가 필요합니다. API를 설정하는 방법은 두 가지가 있습니다.

옵션 1: snakeying/flux-api-worker를 사용하여 배포(권장)

snakeying/flux-api-worker는 Flux 모델에 액세스하기 위한 간단하고 효율적인 Cloudflare Worker를 제공합니다.

1. flux-api-worker 저장소를 포크하세요

2. Cloudflare Workers에 배포:

   • Cloudflare 대시보드에서 새 Worker를 만듭니다.

   • 포크된 저장소에 연결하세요

   • 필요한 환경 변수를 설정하세요.

     • API_KEY : 인증을 위해 선택한 API 키

     • CF_ACCOUNT_ID : Cloudflare 계정 ID

     • CF_API_TOKEN : Workers AI 액세스가 가능한 Cloudflare API 토큰

     • FLUX_MODEL : 사용할 Flux 모델(기본값: "@cf/black-forest-labs/flux-1-schnell")

3. 배포되면 API는 https://your-worker-name.your-subdomain.workers.dev 에서 사용할 수 있습니다.

4. 이 URL을 FLUX_API_URL 로 사용하고 선택한 API 키를 FLUX_API_TOKEN 으로 사용하세요.

옵션 2: aigem/cf-flux-remix를 사용하여 배포

웹 UI로 더 많은 기능을 구현하려면 aigem/cf-flux-remix를 사용할 수 있습니다.

1. cf-flux-remix 저장소 의 설치 지침을 따르세요.

2. 배포되면 배포된 URL에서 API를 사용할 수 있습니다.

3. 이 URL을 FLUX_API_URL 로 사용하고 구성된 API 키를 FLUX_API_TOKEN 으로 사용하세요.

📚 문서

사용 가능한 도구

generate_image

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

{
  prompt: string;                // Required: Text description of the image to generate
  num_inference_steps?: number;  // Optional: Number of denoising steps (1-4) (default: 4)
  aspect_ratio?: string;         // Optional: Aspect ratio (e.g., "16:9", "4:3") (default: "1:1")
}

🔧 사용법

커서 통합

방법 1: mcp.json 사용

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

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx",
      "args": ["-y", "flux-cloudflare-mcp"]
    }
  }
}

2. YOUR_TOKEN 실제 Flux API 토큰으로, YOUR_API_URL API URL로 바꾸세요.

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

방법 2: 커서 MCP 설정 사용

1. 커서를 열고 설정으로 이동하세요

2. "MCP" 또는 "모델 컨텍스트 프로토콜" 섹션으로 이동합니다.

3. "서버 추가" 또는 이와 동등한 것을 클릭하세요.

4. 해당 필드에 다음 명령을 입력하세요.

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

5. YOUR_TOKEN 실제 Flux API 토큰으로, YOUR_API_URL API URL로 바꾸세요.

6. 설정을 저장하고 필요한 경우 커서를 다시 시작하세요.

Claude 데스크톱 통합

env FLUX_API_TOKEN=YOUR_TOKEN FLUX_API_URL=YOUR_API_URL npx -y flux-cloudflare-mcp

{
  "mcpServers": {
    "flux-cloudflare-mcp": {
      "command": "npx",
      "args": ["-y", "flux-cloudflare-mcp"],
      "env": {
        "FLUX_API_TOKEN": "YOUR_TOKEN",
        "FLUX_API_URL": "YOUR_API_URL"
      }
    }
  }
}

💻 지역 개발

1. 저장소를 복제합니다.

git clone https://github.com/Hzzy2O/flux-cloudflare-mcp.git
cd flux-cloudflare-mcp

2. 종속성 설치:

npm install

3. 프로젝트를 빌드하세요:

npm run build

🛠 기술 스택

• 모델 컨텍스트 프로토콜 SDK - 핵심 MCP 기능

• Cloudflare Workers - 이미지 생성을 위한 서버리스 API

• TypeScript - 유형 안전성 및 최신 JavaScript 기능

• Zod - 런타임 유형 검증

⚙️ 구성

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

• FLUX_API_TOKEN : Flux API 인증을 위한 API 토큰

• FLUX_API_URL : 배포된 Flux API의 URL(sneakying/flux-api-worker 또는 aigem/cf-flux-remix에서)

🔍 문제 해결

일반적인 문제

인증 오류

• 환경에서 FLUX_API_TOKEN 올바르게 설정되었는지 확인하세요.

• Flux API로 직접 테스트하여 토큰이 유효한지 확인하세요.

API 연결 문제

• Flux API(Cloudflare Worker)가 실행 중이고 액세스 가능한지 확인하세요.

• 네트워크에서 Cloudflare Workers에 대한 연결이 허용되는지 확인하세요.

안전 필터 작동됨

• 이 모델에는 특정 프롬프트를 차단할 수 있는 내장형 안전 필터가 있습니다.

• 잠재적으로 문제가 될 수 있는 콘텐츠를 피하려면 프롬프트를 수정해 보세요.

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기

📄 라이센스

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

🔗 리소스

• 모델 컨텍스트 프로토콜 문서

• Cloudflare Workers 문서

• 플럭스 모델 문서

• MCP 타입스크립트 SDK

• snakeying/flux-api-worker - 간단한 Flux API 구현

• aigem/cf-flux-remix - 웹 UI를 갖춘 다양한 기능을 갖춘 Flux API