Stability AI MCP Server

아직 MCP에 대해 들어보지 못하셨나요? 최신 정보를 얻는 가장 쉬운 방법은 PulseMCP의 주간 뉴스레터를 읽는 것입니다.

이는 MCP 클라이언트와 Stability AI 의 최신 최고의 Stable Diffusion 이미지 조작 기능(생성, 편집, 업스케일 등)을 통합한 MCP( 모델 컨텍스트 프로토콜 ) 서버입니다.

Stability AI는 선도적인 AI 모델 제공업체이며, 이 서버는 Stability AI의 호스팅 REST API 에 직접 연결됩니다. 시작하려면 stability.ai에서 API 키를 신청해야 합니다.

25 크레딧은 무료로 제공됩니다. 이후부터는 사용량 기반 결제 방식이 매우 합리적입니다. 크레딧당 $0.01이며, 3 크레딧으로 Core 모델에서 이미지를 생성할 수 있습니다. 즉, 고품질 이미지 100장을 $3에 구매할 수 있습니다.

이 프로젝트는 공식적으로 Stability AI와 제휴 관계가 없습니다.

데모 영상 과 티저는 다음과 같습니다.

목차

• 하이라이트
• 역량
• 사용 팁
• 예시
• 설정
  • 치트시트
  • 클로드 데스크탑
    • 수동 설정

하이라이트

학습 곡선 없음 : 이 서버는 합리적인 기본값을 사용하고 이미지 파일 생성 및 조작과 관련된 가장 일반적인 작업에 대해 간단하고 매끄러운 UX를 제공하도록 설계되었습니다. 효과적으로 사용하기 위해 기술적인 지식이나 이미지 모델에 대한 이해가 필요하지 않습니다.

체인 조작 : 이미지를 생성한 다음, 그 안의 항목을 바꾸고 배경을 제거할 수 있습니다... 이 모든 것이 클로드와의 단 한 번의 대화로 가능합니다.

최소 구성 : Stability AI API 키만 있으면 시작할 수 있습니다. 해당 키에 대한 환경 변수와 출력 이미지를 저장할 로컬 디렉터리 경로를 설정하면 준비가 완료됩니다.

동급 최고의 이미지 모델 활용 : Stability AI는 API를 통해 제공되는 이미지 모델을 제공하는 선도적인 공급업체입니다. 이 서버를 사용하면 이미지를 Claude 또는 다른 MCP 클라이언트에 통합할 수 있으며, ChatGPT에서 DALL-E 모델을 사용하는 것보다 훨씬 뛰어납니다.

역량

이 서버는 Claude Desktop을 사용하여 macOS에서 빌드 및 테스트되었습니다. 다른 MCP 클라이언트에서도 작동할 것으로 예상됩니다.

사용 팁

• 처리된 모든 이미지는 자동으로 IMAGE_STORAGE_DIRECTORY 에 저장되고 미리 볼 수 있으며 리소스로 사용할 수 있습니다.
• Claude에 이미지 파일을 복사/붙여넣기하거나 업로드하지 마세요 . Claude는 어디에도 이미지를 저장하지 않으므로 MCP 서버에서는 이미지를 처리할 수 없습니다. 이미지는 IMAGE_STORAGE_DIRECTORY 에 "업로드"(저장)해야 채팅에서 사용 가능한 리소스로 표시됩니다.
• 직접 문구를 작성하는 대신 미리 로드된 프롬프트를 사용할 수 있습니다.

예시

이미지 생성

1. Generate an image of a cat
2. Generate a photorealistic image of a cat in a cyberpunk city, neon lights reflecting off its fur, 16:9 aspect ratio
3. Generate a detailed digital art piece of a cat wearing a space suit floating through a colorful nebula, style preset: digital-art, aspect ratio: 21:9

SD3.5로 이미지 생성

1. Generate an image of a woman with cybernetic wolf ears using the SD3.5 model, with the "neon-punk" style preset
2. Generate an image of a futuristic city using the SD3.5 Large Turbo model, with aspect ratio 16:9
3. Generate an image of an astronaut on mars using the SD3.5 Large model, with cfg scale 7.5, "analog-film" style preset, and seed 42

배경 제거

1. Remove the background from the image I just generated
2. Remove the background from product-photo.jpg to prepare it for my e-commerce site
3. Remove the background from group-photo.png so I can composite it with another image

아웃페인트(자르기 해제)

1. Extend vacation-photo.jpg 500 pixels to the right to include more of the beach
2. Extend family-portrait.png 300 pixels up to show more of the mountains, and 200 pixels right to include more landscape
3. Extend artwork.png in all directions to create a wider fantasy forest scene that matches the original environment

검색 및 바꾸기

1. In my last image, replace the red car with a blue car
2. In portrait.png, replace the plain background with a sunset over mountains
3. In landscape.jpg, replace the modern buildings with victorian-era architecture while maintaining the same atmosphere

고급형

1. Upscale profile-pic.jpg for better resolution
2. Upscale product-photo.png to make it print-ready

그래도 출력 결과가 만족스럽지 않다면 다시 확장할 수 있습니다.

1. Try again with better quality

컨트롤 스케치

1. Transform sketch.png into a colored illustration for a children's book
2. Convert wireframe.jpg into a detailed 3D render for a modern architectural visualization

컨트롤 스타일

1. Generate an image in the style of the reference image

제어 구조

1. Generate an image while maintaining the structure of the reference image

배경 교체 및 조명 변경

1. Replace the background of the image I just generated with a sunset over mountains

검색 및 다시 칠하기

1. In my last image, make the red car be blue instead

설정

메타데이터 로깅

서버는 추적 및 문제 해결에 도움이 되도록 이미지 생성 요청의 메타데이터를 저장할 수 있습니다.

활성화하면 생성된 이미지와 동일한 이름의 .txt 파일이 같은 디렉터리에 생성됩니다. 이 파일에는 다음이 포함됩니다.

• 요청의 타임스탬프
• 모든 요청 매개변수(프롬프트, 모델, 스타일 사전 설정 등)
• 응답 정보(성공 상태, 생성 시간)

SAVE_METADATA_FAILED 활성화된 경우 실패한 요청에 대해서도 이 파일이 생성됩니다.

치트시트

클로드 데스크탑

영상 튜토리얼을 선호하신다면, 여기 간단한 영상 튜토리얼이 있습니다.

생성되거나 수정된 이미지를 저장할 폴더 디렉터리를 컴퓨터 어딘가에 만드세요. 다음과 같은 방법이 있습니다.

• /Users/<username>/Downloads/stability-ai-images
• /Users/<username>/Library/Application Support/Claude/mcp-server-stability-ai/images

그리고 Stability AI의 API 키가 있는지 확인하세요.

그런 다음 아래에서 원하는 서버 구성 방법을 선택하세요. MCP 서버를 처음 사용하는 경우, Claude Desktop 애플리케이션이 설치되어 있는지 확인하고 공식 MCP 설정 지침을 따르세요.

수동 설정

터미널에서 npx 명령을 실행하려면 컴퓨터에 Node가 설치되어 있어야 합니다. Node가 없다면 nodejs.org 에서 설치할 수 있습니다.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json 파일을 수정하여 다음을 추가합니다.

지엑스피1

Claude Desktop을 다시 시작하면 사용할 준비가 됩니다.

Smithery를 통해 설치

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

SSE 모드

다음 명령을 사용하여 이 서버를 시작하면 SSE 모드에서 실행할 수 있습니다.

이 모드는 HTTP를 통해 타사 사용을 위해 서버를 배포하려는 경우에 유용합니다.

서버가 로컬 파일 시스템 대신 Google Cloud Storage에 이미지 파일을 저장하므로 GCS_PROJECT_ID , GCS_CLIENT_EMAIL , GCS_BUCKET_NAME 및 GCS_PRIVATE_KEY 환경 변수를 설정해야 합니다.

멀티테넌시 방식은 매우 순진하고 안전하지 않다는 점에 유의하세요. 요청자의 IP 주소를 사용하여 이미지 저장에 사용되는 GCS 접두사를 분할하고, 모든 이미지를 공개적으로 접근 가능하게 하여 MCP 클라이언트로 다시 전송합니다. 따라서 이론적으로 누군가 사용자의 IP 주소와 생성한 파일 이름을 알고 있다면 URL을 추측하여 이미지에 접근할 수 있습니다.

로드맵

최근 완료:

• ✅ Stable Diffusion 3.5 모델에 대한 지원이 추가되었습니다.
• ✅ Stable Image Ultra에 대한 지원이 추가되었습니다.
• ✅ 이미지 생성 요청에 대한 메타데이터 로깅이 추가되었습니다.

곧 출시될 예정입니다. 홍보는 환영합니다! CONTRIBUTING.md를 참조하세요.

• inpaint - search-and-x 기능의 보다 정확한 버전으로, 교체할 영역을 정의하기 위해 마스크를 관리해야 합니다.
• 기본 이미지 조작(자르기, 회전, 크기 조정 등): 자체 MCP 서버로 작동할 가능성이 높음
• 한 이미지를 다른 이미지에 인페인트하는 기능입니다. Stability API로는 불가능해 보입니다. 이를 구현하려면 다른 MCP 서버에서 다른 API를 사용하는 것이 좋을 것 같습니다.
• 이미지 조작을 위해 맞춤 제작된 MCP 클라이언트

기여하다

외부 기여를 환영합니다! 자세한 내용은 CONTRIBUTING.md를 참조하세요.

또한 문제점이나 기능 요청을 자유롭게 제기해 주시기 바랍니다. 사람들이 이것을 어떻게 사용하는지, 어떻게 개선할 수 있을지 보는 것을 좋아합니다.