remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Integrates with Windsurf/Codeium Cascade (Wave 3+), allowing users to access image generation tools through Cascade's MCP toolbar and AI capabilities
Integrates with Flux's image generation API, allowing for text-to-image generation, image-to-image transformation, inpainting, and advanced image controls like edge-based, depth-aware, and pose-guided generation

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

빠른 시작

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

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

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

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

선적 서류 비치

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

IDE 통합

커서(v0.45.7+)

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

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

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

Windsurf의 Cascade AI와 통합:

구성
- ~/.codeium/windsurf/mcp_config.json 편집하세요
- 프로세스 기반 도구 실행을 지원합니다
- JSON으로 구성된 환경 변수
용법
- 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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

Flux의 고급 이미지 생성 및 조작 기능을 AI 코딩 어시스턴트에 통합하여 Cursor 및 Windsurf와 같은 IDE에서 원활한 텍스트-이미지 변환 및 이미지 제어 워크플로를 구현하는 서버입니다.

Related Resources

Reddit Discussion about this server