MCP Flux Studio

MCP 플럭스 스튜디오

Flux의 고급 이미지 생성 기능을 AI 코딩 어시스턴트에 제공하는 강력한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Flux의 이미지 생성, 조작 및 제어 기능을 Cursor 및 Windsurf(Codeium) IDE에 직접 통합할 수 있습니다.

개요

MCP Flux Studio는 AI 코딩 어시스턴트와 Flux의 강력한 이미지 생성 API 간의 격차를 해소하여 이미지 생성 기능을 개발 워크플로에 원활하게 통합할 수 있도록 해줍니다.

특징

• 이미지 생성
  • 정밀한 제어를 통한 텍스트-이미지 생성
  • 다양한 모델 지원(flux.1.1-pro, flux.1-pro, flux.1-dev, flux.1.1-ultra)
  • 사용자 정의 가능한 종횡비 및 치수
• 이미지 조작
  • 이미지-이미지 변환
  • 사용자 정의 가능한 마스크로 페인팅
  • 해상도 확대 및 향상
• 고급 컨트롤
  • 엣지 기반 생성(canny)
  • 깊이 인식 세대
  • 포즈 가이드 생성
• IDE 통합
  • 커서에 대한 전체 지원(v0.45.7+)
  • Windsurf/Codeium Cascade(Wave 3+)와 호환 가능
  • AI 어시스턴트를 통한 원활한 도구 호출

빠른 시작

1. 필수 조건
   • 노드.js 18+
   • 파이썬 3.12+
   • 플럭스 API 키
   • 호환 IDE(Cursor 또는 Windsurf)
2. 설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Flux Studio를 자동으로 설치하려면:

지엑스피1

수동 설치

3. 기본 구성
   BFL_API_KEY=your_flux_api_key FLUX_PATH=/path/to/flux/installation

IDE별 구성 및 문제 해결을 포함한 자세한 설정 지침은 설치 가이드를 참조하세요.

선적 서류 비치

• 설치 가이드 - 포괄적인 설정 지침
• API 문서 - 자세한 도구 문서
• 예시 사용 - 실제 사용 예시
• 기여 지침 - 기여 방법

IDE 통합

커서(v0.45.7+)

MCP Flux Studio는 Cursor의 AI 어시스턴트와 완벽하게 통합됩니다.

1. 구성
   • 설정 > 기능 > MCP를 통해 구성하세요.
   • stdio와 SSE 연결을 모두 지원합니다
   • 환경 변수는 래퍼 스크립트를 통해 설정할 수 있습니다.
2. 용법
   • Cursor의 AI 어시스턴트가 자동으로 사용할 수 있는 도구
   • 도구 호출에는 사용자 승인이 필요합니다.
   • 세대 진행 상황에 대한 실시간 피드백

윈드서핑/코디움(파도 3+)

Windsurf의 Cascade AI와 통합:

1. 구성
   • ~/.codeium/windsurf/mcp_config.json 편집하세요
   • 프로세스 기반 도구 실행을 지원합니다
   • JSON으로 구성된 환경 변수
2. 용법
   • Cascade의 MCP 도구 모음을 통해 도구에 액세스하세요
   • 자동 도구 검색 및 로딩
   • Cascade의 AI 기능과 통합

IDE별 자세한 설정 지침은 설치 가이드를 참조하세요.

용법

서버는 다음과 같은 도구를 제공합니다.

생성하다

텍스트 프롬프트에서 이미지를 생성합니다.

이미지2이미지

다른 이미지를 참조하여 이미지를 생성합니다.

인페인트

마스크를 사용하여 이미지를 칠합니다.

제어

구조적 제어를 사용하여 이미지를 생성합니다.

개발

프로젝트 구조

테스트 실행

건물

기여하다

행동 강령과 풀 리퀘스트 제출 프로세스에 대한 자세한 내용은 CONTRIBUTING.md를 읽어보세요.

특허

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

감사의 말

• 모델 컨텍스트 프로토콜 - 프로토콜 사양
• Flux API - 기본 이미지 생성 API