JinDaGe - mcp-server-stability-ai MCP Details

article

README

🚀 Claude桌面应用的MCP服务器

这是一个专为Claude桌面应用打造的MCP服务器，借助Stability AI的API，可实现图像生成与操作。用户只需发送特定指令，就能调用Stable Diffusion等模型，轻松完成图像生成、编辑等任务。

🚀 快速开始

📦 安装指南

手动安装

在计算机上创建一个用于存储生成或修改后图像的文件夹，推荐路径如下：
- macOS: /Users/<用户名>/Downloads/stability-ai-images
- Windows: %APPDATA%\Claude\mcp-server-stability-ai\images
确保已安装Node.js环境，以便运行 npx 命令。若未安装，可从 Node.js 官网下载安装。
修改 claude_desktop_config.json 文件，添加以下内容：

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

重启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_API_KEY | Stability AI的API密钥 | sk-1234567890 | | GCS_PROJECT_ID | Google Cloud项目ID | your-project-id | | GCS_CLIENT_EMAIL | Google Cloud服务账户邮箱 | service-account@project.iam.gserviceaccount.com | | GCS_PRIVATE_KEY | Google Cloud私钥 | -----BEGIN PRIVATE KEY-----<br>YourKeyHere<br>-----END PRIVATE KEY----- | | GCS_BUCKET_NAME | Google Cloud Storage存储桶名称 | your-bucket-name |

日志与监控

服务器运行时会输出详细日志，便于调试和监控。日志内容包括：

请求处理时间
操作类型
错误信息（如有）

教程与视频

如果你更喜欢视频教程，可以参考以下链接：如何配置和使用Stability AI MCP服务器

问题排查

常见问题

无法连接到Stability AI API
- 确保已正确设置 STABILITY_AI_API_KEY
- 检查网络连接，确保可以访问外部服务
图像生成失败
- 查看日志文件，获取具体错误信息
- 确保输入的提示描述清晰且符合模型要求
性能问题
- 确保硬件配置足够（推荐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 文件。

mcp-server-stability-ai