MCP Server Stability Ai

🚀 このプロジェクトについて

このプロジェクトはClaudeデスクトップアプリ用のMCPサーバーです。Stability AIのAPIを通じて、画像生成や操作をサポートしています。ユーザーは特定のコマンドを送信することで、Stable Diffusionなどのモデルを呼び出し、画像生成や編集などの機能を実現できます。

✨ 主な機能

• テキストから画像生成：Stable Diffusionモデルを使用して、テキスト記述を画像に変換します。
• 画像操作：画像の検索と置換（search-and-x）、修復（inpaint）などの高度な操作が可能です。
• モデルサポート：最新のStable Diffusion 3.5シリーズモデルと互換性があります。

🚀 クイックスタート

📦 インストール

手動インストール

1. 生成または修正した画像を保存するためのフォルダを作成します。推奨パスは以下の通りです。
   • macOS: /Users/<ユーザー名>/Downloads/stability-ai-images
   • Windows: %APPDATA%\Claude\mcp-server-stability-ai\images
2. npx コマンドを実行するために、Node.js環境が必要です。ない場合は、Node.js公式サイト からダウンロードしてインストールしてください。
3. claude_desktop_config.json ファイルを編集し、以下の内容を追加します。

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

4. Claudeデスクトップアプリを再起動して、設定を完了します。

Smitheryを使用したインストール

Smitheryを使用して自動インストールするには、以下のコマンドを実行します。

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

SSEモード

サーバーをHTTPサービスとして第三者が使用できるようにする場合は、SSEモードを起動できます。

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

このモードでは、Google Cloud Storageを使用して画像ファイルを保存するために、以下の環境変数を設定する必要があります。

• GCS_PROJECT_ID
• GCS_CLIENT_EMAIL
• GCS_BUCKET_NAME
• GCS_PRIVATE_KEY

このモードのマルチテナント分離メカニズムは基本的で安全ではないことに注意してください。リクエスターのIPアドレスを使用してプレフィックスを分割し、すべての画像が公開されます。

💻 使用例

基本的な使用法

テキストから画像生成

Stable Diffusionモデルを使用して、テキスト記述を高品質な画像に変換します。

/stability-ai generate --prompt "飛んでいるフクロウ"

画像操作

様々な画像操作機能がサポートされています。

検索と置換（search-and-x）

検索語と置換語を指定して、画像内容を変更します。

/stability-ai search-and-replace --prompt "飛んでいるフクロウ" --negative_prompt "空"

修復（inpaint）

画像を修復または変更するには、修復領域のマスクを提供する必要があります。

/stability-ai inpaint --image_path "path/to/image.jpg" --mask_path "path/to/mask.png"

高度な使用法

このサーバーは最新のStable Diffusion 3.5シリーズモデルをサポートしています。

• SD 3.5 Base
• SD 3.5 Fine-tuned for images
• SDXL

📚 ドキュメント

環境変数設定

サーバーを実行する際に、以下の環境変数を設定することで、動作をカスタマイズできます。

| `GCS_BUCKET_NAME`     | Google Cloud Storageのバケット名      | `your-bucket-name`           |

### ログと監視
サーバーは詳細なログを出力し、デバッグと監視を容易にします。ログには以下の内容が含まれます。
- リクエスト処理時間
- 操作タイプ
- エラー情報（ある場合）

### チュートリアルとビデオ
ビデオチュートリアルが必要な場合は、以下のリンクを参照してください。
[Stability AI MCPサーバーの設定と使用方法](https://example.com/video-tutorial)

### 問題解決
#### よくある問題
1. **Stability AI APIに接続できない**
   - `STABILITY_AI_API_KEY` が正しく設定されていることを確認してください。
   - ネットワーク接続を確認し、外部サービスにアクセスできることを確認してください。
2. **画像生成に失敗する**
   - ログファイルを確認して、具体的なエラー情報を取得してください。
   - 入力されたプロンプトが明確で、モデルの要件を満たしていることを確認してください。
3. **パフォーマンスの問題**
   - ハードウェア構成が十分であることを確認してください（GPUアクセラレーションを推奨）。
   - 生成パラメータを最適化し、解像度を下げるか反復回数を減らしてください。

## 更新履歴

### バージョン1.0.0
- 初回リリース。基本的なテキストから画像生成と `search-and-replace` 機能をサポート。
- Stable Diffusion 3.5シリーズモデルと互換性。

### バージョン1.1.0
- `inpaint` 機能を追加。
- Google Cloud Storageの統合をサポート。
- ログシステムを最適化し、デバッグ効率を向上。

### バージョン1.2.0
- SSEモードのセキュリティを強化。
- マルチテナント分離メカニズムを改善。
- 全体的なパフォーマンスと安定性を向上。

## 貢献とサポート

### コードの貢献
コミュニティからのコード貢献を歓迎します！詳細な貢献ガイドは [GitHubリポジトリ](https://github.com/your-org/mcp-server-stability-ai) を参照してください。

### サポートの取得
ヘルプが必要な場合や問題が発生した場合は、以下の方法で連絡してください。
- **メール**：support@stability.ai
- **フォーラム**：[Stability AIコミュニティフォーラム](https://forum.stability.ai)

## 📄 ライセンス
このプロジェクトは [MIT License](LICENSE) に基づいてライセンスされています。詳細な条項は同梱の LICENSE ファイルを参照してください。