Stability AI MCP Server

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Optionally stores generated images in Google Cloud Storage when running in SSE mode, allowing the server to be deployed for third-party usage over HTTP.

MCP についてまだ聞いたことがありませんか? 最新情報を入手する最も簡単な方法は、PulseMCP で毎週配信されるニュースレターを読むことです。


これは、MCP クライアントとStability AIの最新かつ最高の Stable Diffusion 画像操作機能 (生成、編集、アップスケールなど) を統合する MCP (モデル コンテキスト プロトコル) サーバーです。

Stability AIは、業界をリードするAIモデルプロバイダーです。このサーバーは、Stability AIがホストするREST APIに直接接続します。ご利用を開始するには、 stability.aiからAPIキーを取得する必要があります。

25クレジットまで無料で提供されます。その後は従量課金制で、1クレジットあたり0.01ドルと非常にリーズナブルです。3クレジットでCoreモデルの画像生成が1回できます。つまり、高画質画像100枚でたったの3ドルです。

このプロジェクトは Stability AI と正式に提携していません。

デモビデオとティーザーはこちらをご覧ください:

目次

ハイライト

学習曲線なし:このサーバーは、画像ファイルの生成と操作に関連する最も一般的な操作に対して、合理的なデフォルト設定を使用し、シンプルでスムーズなUXを提供するように設計されています。効果的に使用するために、技術的な知識や画像モデルに関する知識は必要ありません。

チェーン操作: 画像を生成し、その中のアイテムを置き換え、背景を削除するなど、すべて 1 回の Claude 会話で実行できます。

最小限の設定:開始に必要なのはStability AI APIキーだけです。環境変数と出力画像を保存するローカルディレクトリのパスを設定するだけで準備完了です。

クラス最高の画像モデルを活用:Stability AIは、API経由で公開される画像モデルのリーディングプロバイダーです。このサーバーを使用することで、Claudeやその他のMCPクライアントに画像モデルを統合できます。ChatGPTでDALL-Eモデルを使用するよりも、はるかに優れたエクスペリエンスを実現します。

機能

このサーバーはmacOSのClaude Desktop上で構築・テストされています。他のMCPクライアントでも動作するはずです。

ツール名説明安定性APIの推定コスト
generate-image提供されたプロンプトとその他のオプション パラメータに基づいて、あらゆるものの高品質な画像を生成します。0.03ドル
generate-image-sd35高度な構成オプションを備えた Stable Diffusion 3.5 モデルを使用して画像を生成します。0.04ドル~0.07ドル
remove-background画像から背景を削除します。0.02ドル
outpaint視覚的な一貫性を維持しながら、画像を任意の方向に拡張します。0.04ドル
search-and-replace何を置き換えるか、何に置き換えるかを指定して、画像内のオブジェクトまたは要素を置き換えます。0.04ドル
upscale-fast画像の解像度を4倍に向上します。0.01ドル
upscale-creative画像解像度を最大 4K まで向上します。0.25ドル
control-sketch手描きのスケッチを製品グレードの画像に変換します。0.03ドル
control-style参照画像のスタイルで画像を生成します。0.04ドル
control-structure参照画像の構造を維持しながら画像を生成します。0.03ドル
replace-background-and-relight画像の背景を置き換えて、照明を当て直します。0.08ドル
search-and-recolor画像内のオブジェクトを検索して色を変更します。0.05ドル

使用上のヒント

  • 処理されたすべての画像は自動的に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

設定

チートシート

環境変数説明必須デフォルト値
STABILITY_AI_API_KEYStability AI APIキー。platform.stability.aiで取得してください。はい該当なしsk-1234567890
IMAGE_STORAGE_DIRECTORY生成された画像が保存されるディレクトリ/tmp/tadasant-mcp-server-stability-aiまたはC:\\Windows\\Temp\\mcp-server-stability-ai/Users/admin/Downloads/stability-ai-images
GCS_PROJECT_ID画像を保存するための Google Cloud プロジェクト IDN (SSE を使用する場合は Y)該当なしyour-project-id
GCS_CLIENT_EMAIL画像を保存するための Google Cloud サービス アカウント クライアントのメールN (SSE を使用する場合は Y)該当なしyour-service-account@project.iam.gserviceaccount.com
GCS_PRIVATE_KEY画像を保存するための Google Cloud サービス アカウントの秘密鍵N (SSE を使用する場合は Y)該当なし-----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n
GCS_BUCKET_NAME画像を保存するための Google Cloud Storage バケット名N (SSE を使用する場合は Y)該当なしyour-bucket-name

クロードデスクトップ

ビデオチュートリアルをご希望の場合は、こちらに簡単なチュートリアルがあります。

生成/変更した画像を保存するためのフォルダディレクトリをマシン上の任意の場所に作成します。いくつかのオプションがあります。

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

また、 Stability AI からの API キーがあることを確認してください。

次に、以下のサーバー設定方法に進んでください。MCPサーバーを初めてご利用になる場合は、 Claudeデスクトップアプリケーションがインストールされていることを確認し、 MCP公式セットアップ手順に従ってください。

手動設定

ターミナルでnpxコマンドを実行するには、マシン上でNode.jsが動作している必要があります。Node.jsがインストールされていない場合は、 nodejs.orgからインストールできます。

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.jsonファイルを変更して、以下を追加します。

{ "mcpServers": { "stability-ai": { "command": "npx", "args": [ "-y", "mcp-server-stability-ai" ], "env": { "STABILITY_AI_API_KEY": "sk-1234567890" } } } }

Claude Desktop を再起動すれば準備完了です。

Smithery経由でインストール

Smithery経由で Claude Desktop を自動的にインストールするには:

npx @smithery/cli install mcp-server-stability-ai --client claude

SSEモード

このサーバーは、次のコマンドで起動することで SSE モードで実行するオプションがあります。

npx mcp-server-stability-ai -y --sse

このモードは、このサーバーを HTTP 経由でサードパーティが使用できるように展開する場合に便利です。

サーバーはローカル ファイル システムではなく Google Cloud Storage に画像ファイルを保存するため、 GCS_PROJECT_IDGCS_CLIENT_EMAILGCS_BUCKET_NAMEGCS_PRIVATE_KEY環境変数を設定する必要があります。

マルチテナンシーの仕組みは非常に単純で安全性に欠けることに注意してください。画像の保存に使用されるGCSプレフィックスをリクエスタのIPアドレスで分割し、MCPクライアントに画像を返信するためにすべての画像をパブリックアクセス可能にしています。そのため、理論上は、誰かがあなたのIPアドレスと生成したファイル名を知っていれば、URLを推測して画像にアクセスできてしまいます。

ロードマップ

最近完了:

  • ✅ 最新の Stable Diffusion 3.5 モデルのサポートを追加しました

これらは近日公開予定ですが、PR も歓迎します。CONTRIBUTING.mdをご覧ください。

  • inpaint - search-and-x機能のより正確なバージョンで、置換する領域を定義するためにマスクを管理する必要があります。
  • 基本的な画像操作(切り取り、回転、サイズ変更など):おそらく独自のMCPサーバーとして
  • ある画像を別の画像にインペイントする機能。Stability APIでは不可能なようです。これを実現するには、別のMCPサーバーから別のAPIにアクセスする必要があるでしょう。
  • 画像操作用にカスタマイズされたMCPクライアント

貢献

外部からの貢献も歓迎します!詳しくはCONTRIBUTING.mdをご覧ください。

また、問題や機能のリクエストもお気軽にお寄せください。人々がこれをどのように使用し、どのように改善できるかを知るのは楽しいです。

ID: arwjcxkkhg