MCP Server Stability Ai

🚀 Claude桌面應用的MCP服務器

這是一個專為Claude桌面應用打造的MCP服務器，藉助Stability AI的API，可實現圖像生成與操作。用戶只需發送特定指令，就能調用Stable Diffusion等模型，輕鬆完成圖像生成、編輯等任務。

🚀 快速開始

📦 安裝指南

手動安裝

1. 在計算機上創建一個用於存儲生成或修改後圖像的文件夾，推薦路徑如下：
   • macOS: /Users/<用戶名>/Downloads/stability-ai-images
   • Windows: %APPDATA%\Claude\mcp-server-stability-ai\images
2. 確保已安裝Node.js環境，以便運行 npx 命令。若未安裝，可從 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模型，將文本描述轉化為圖像。
• 圖像操作：涵蓋圖像的搜索與替換（search-and-x）、修復（inpaint）等高級操作。
• 模型支持：兼容最新的Stable Diffusion 3.5系列模型。

💻 使用示例

基礎用法

文本到圖像生成

使用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"

📚 詳細文檔

配置指南

環境變量配置

在服務器運行時，可通過設置以下環境變量來自定義行為：

日誌與監控

服務器運行時會輸出詳細日誌，便於調試和監控。日誌內容包括：

• 請求處理時間
• 操作類型
• 錯誤信息（如有）

教程與視頻

如果你更喜歡視頻教程，可以參考以下鏈接： 如何配置和使用Stability AI MCP服務器

問題排查

常見問題

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 倉庫 查看詳細貢獻指南。

獲取支持

如需幫助或遇到問題，請聯繫：

• 郵件：support@stability.ai
• 論壇：Stability AI 社區論壇

📄 許可證

本項目遵循 MIT License 許可證，具體條款請參考隨附的 LICENSE 文件。