🚀 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 文件。