이미지 생성 MCP 서버
Together AI를 통해 Flux.1 Schnell 모델을 사용하여 고품질 이미지를 원활하게 생성할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 이미지 생성 매개변수를 지정하기 위한 표준화된 인터페이스를 제공합니다.
특징
Flux.1 Schnell 모델을 기반으로 하는 고품질 이미지 생성
사용자 정의 가능한 크기(폭 및 높이) 지원
신속한 검증 및 API 문제에 대한 명확한 오류 처리
MCP 호환 클라이언트와의 쉬운 통합
PNG 형식으로 디스크에 선택적 이미지 저장
Related MCP server: Image Generation MCP Server
설치
지엑스피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 키
api.together.xyz 에 로그인하세요
API 키 설정 으로 이동
새로운 API 키를 생성하려면 "생성"을 클릭하세요.
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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.