이미지 생성 MCP 서버

Together AI를 통해 Flux.1 Schnell 모델을 사용하여 고품질 이미지를 원활하게 생성할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 이미지 생성 매개변수를 지정하기 위한 표준화된 인터페이스를 제공합니다.

특징

Flux.1 Schnell 모델을 기반으로 하는 고품질 이미지 생성
사용자 정의 가능한 크기(폭 및 높이) 지원
신속한 검증 및 API 문제에 대한 명확한 오류 처리
MCP 호환 클라이언트와의 쉬운 통합
PNG 형식으로 디스크에 선택적 이미지 저장

설치

지엑스피1

또는 직접 실행:

npx together-mcp@latest

구성

MCP 서버 구성에 다음을 추가합니다.

{
  "mcpServers": {
    "together-image-gen": {
      "command": "npx",
      "args": ["together-mcp@latest -y"],
      "env": {
        "TOGETHER_API_KEY": "<API KEY>"
      }
    }
  }
}

용법

서버는 generate_image 라는 하나의 도구를 제공합니다.

generate_image 사용

이 도구에는 필수 매개변수인 프롬프트 하나만 있습니다. 다른 모든 매개변수는 선택 사항이며, 지정하지 않으면 적절한 기본값이 사용됩니다.

매개변수

{
  // Required
  prompt: string;          // Text description of the image to generate

  // Optional with defaults
  model?: string;          // Default: "black-forest-labs/FLUX.1-schnell-Free"
  width?: number;          // Default: 1024 (min: 128, max: 2048)
  height?: number;         // Default: 768 (min: 128, max: 2048)
  steps?: number;          // Default: 1 (min: 1, max: 100)
  n?: number;             // Default: 1 (max: 4)
  response_format?: string; // Default: "b64_json" (options: ["b64_json", "url"])
  image_path?: string;     // Optional: Path to save the generated image as PNG
}

최소 요청 예

프롬프트만 필요합니다:

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset"
  }
}

이미지 저장을 포함한 전체 요청 예시

기본값을 무시하고 이미지를 저장할 경로를 지정합니다.

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A serene mountain landscape at sunset",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "n": 1,
    "response_format": "b64_json",
    "model": "black-forest-labs/FLUX.1-schnell-Free",
    "image_path": "/path/to/save/image.png"
  }
}

응답 형식

응답은 다음을 포함하는 JSON 객체가 됩니다.

{
  "id": string,        // Generation ID
  "model": string,     // Model used
  "object": "list",
  "data": [
    {
      "timings": {
        "inference": number  // Time taken for inference
      },
      "index": number,      // Image index
      "b64_json": string    // Base64 encoded image data (if response_format is "b64_json")
      // OR
      "url": string        // URL to generated image (if response_format is "url")
    }
  ]
}

image_path가 제공되고 저장이 성공하면 응답에 저장 위치 확인이 포함됩니다.

기본값

요청에 지정되지 않은 경우 다음 기본값이 사용됩니다.

모델: "black-forest-labs/FLUX.1-schnell-Free"
너비: 1024
키: 768
단계: 1
명: 1
응답_형식: "b64_json"

중요 참고 사항

prompt 매개변수만 필요합니다.
모든 선택적 매개변수는 제공되지 않으면 기본값을 사용합니다.
제공되는 경우 매개변수는 제약 조건(예: 너비/높이 범위)을 충족해야 합니다.
Base64 응답은 클 수 있습니다. 더 큰 이미지에는 URL 형식을 사용하세요.
이미지를 저장할 때 지정된 디렉토리가 존재하고 쓰기 가능한지 확인하십시오.

필수 조건

노드.js >= 16
Together AI API 키
1. api.together.xyz 에 로그인하세요
2. API 키 설정 으로 이동
3. 새로운 API 키를 생성하려면 "생성"을 클릭하세요.
4. MCP 구성에서 사용할 생성된 키를 복사하세요.

종속성

{
  "@modelcontextprotocol/sdk": "0.6.0",
  "axios": "^1.6.7"
}

개발

프로젝트를 복제하고 빌드합니다.

git clone https://github.com/manascb1344/together-mcp-server
cd together-mcp-server
npm install
npm run build

사용 가능한 스크립트

npm run build - TypeScript 프로젝트 빌드
npm run watch - 변경 사항을 확인하고 다시 빌드합니다.
npm run inspector - MCP 검사기 실행

기여하다

여러분의 참여를 환영합니다! 다음 단계를 따라주세요.

저장소를 포크하세요
새로운 브랜치( feature/my-new-feature )를 생성합니다.
변경 사항을 커밋하세요
가지를 포크로 밀어 넣으세요
풀 리퀘스트 열기

기능 요청 및 버그 리포트는 GitHub Issues를 통해 제출하실 수 있습니다. 새 이슈를 생성하기 전에 기존 이슈를 확인해 주세요.

중요한 변경 사항이 있는 경우, 제안된 변경 사항을 논의하기 위해 먼저 이슈를 열어주세요.

특허

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

Image Generation MCP Server

Integrations