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 어시스턴트를 통한 원활한 도구 호출

Related MCP server: Minimax MCP Tools

빠른 시작

1. 필수 조건

   • 노드.js 18+

   • 파이썬 3.12+

   • 플럭스 API 키

   • 호환 IDE(Cursor 또는 Windsurf)

2. 설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

git clone https://github.com/jmanhype/mcp-flux-studio.git
cd mcp-flux-studio
npm install
npm run build

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별 자세한 설정 지침은 설치 가이드를 참조하세요.

용법

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

생성하다

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

{
  "prompt": "A photorealistic cat",
  "model": "flux.1.1-pro",
  "aspect_ratio": "1:1",
  "output": "generated.jpg"
}

이미지2이미지

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

{
  "image": "input.jpg",
  "prompt": "Convert to oil painting",
  "model": "flux.1.1-pro",
  "strength": 0.85,
  "output": "output.jpg",
  "name": "oil_painting"
}

인페인트

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

{
  "image": "input.jpg",
  "prompt": "Add flowers",
  "mask_shape": "circle",
  "position": "center",
  "output": "inpainted.jpg"
}

제어

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

{
  "type": "canny",
  "image": "control.jpg",
  "prompt": "A realistic photo",
  "output": "controlled.jpg"
}

개발

프로젝트 구조

flux-mcp-server/
├── src/
│   ├── index.ts          # Main server implementation
│   └── types.ts          # TypeScript type definitions
├── tests/
│   └── server.test.ts    # Server tests
├── docs/
│   ├── API.md           # API documentation
│   └── CONTRIBUTING.md  # Contribution guidelines
├── examples/
│   ├── generate.json    # Example tool usage
│   └── config.json      # Example configuration
├── package.json
├── tsconfig.json
└── README.md

테스트 실행

npm test

건물

npm run build

기여하다

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

특허

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

감사의 말

• 모델 컨텍스트 프로토콜 - 프로토콜 사양

• Flux API - 기본 이미지 생성 API