稳定性AI MCP服务器
项目介绍
还没听说过MCP？最简单的方法是阅读我们的PulseMCP每周通讯。
这是一个MCP（模型上下文协议）服务器，它将MCP客户端与Stability AI的最新图像处理功能集成在一起：生成、编辑、放大等。
Stability AI是一家领先的AI模型提供商，此服务器直接连接到他们的托管REST API。您需要在stability.ai注册一个API密钥才能开始使用。
他们提供25个免费积分。之后，按需计费的价格非常合理：每积分$0.01，3个积分可以生成一张核心模型的图片。所以100张高质量图片只需$3。
本项目与Stability AI没有正式关联。
演示视频，以及预告片：
目录
亮点
无学习曲线：此服务器设计了合理的默认值，并提供了简单的用户体验，用于最常见的图像文件生成和操作。您不需要具备技术背景或了解任何关于图像模型的知识即可有效使用它。
链式操作：您可以生成一张图片，然后替换其中的某个物品，再移除背景……所有这些都可以在一个Claude对话中完成。
最小配置：您只需要一个Stability AI API密钥就可以开始使用。设置环境变量并指定本地目录路径来存储输出图片，即可开始使用。
利用顶级图像模型：Stability AI是通过API提供的图像模型的主要供应商。使用此服务器可以将其集成到Claude或其他MCP客户端中——这比在ChatGPT中使用DALL-E模型要好得多。
功能
此服务器已在macOS上构建和测试，配合Claude Desktop使用。它也应该与其他MCP客户端兼容。
| 工具名称 | 描述 | 预估Stability 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，然后才会出现在聊天中的可用资源中。 - 您可以使用预加载的提示而不是自己编写文本：
示例
生成图像
生成一张猫的图像生成一张在赛博朋克城市中的猫的逼真图像，霓虹灯反射在其毛发上，16:9宽高比生成一幅穿着太空服漂浮在多彩星云中的猫的详细数字艺术作品，样式预设：数字艺术，宽高比：21:9
使用SD3.5生成图像
使用SD3.5模型生成一位带有赛博狼耳的女人的图像，使用“霓虹朋克”样式预设使用SD3.5大型Turbo模型生成未来城市的图像，宽高比16:9使用SD3.5大型模型生成火星上的宇航员图像，cfg比例7.5，“模拟胶片”样式预设，种子42
移除背景
移除我刚刚生成的图像的背景移除product-photo.jpg的背景，以准备用于我的电子商务网站移除group-photo.png的背景，以便我可以将其与另一张图像合成
外扩（解裁）
将vacation-photo.jpg向右扩展500像素，以包含更多的海滩将family-portrait.png向上扩展300像素，显示更多的山脉，并向右扩展200像素，包含更多景观将artwork.png向所有方向扩展，创建一个更广阔的幻想森林场景，匹配原始环境
搜索并替换
在我的最后一张图像中，将红色汽车替换为蓝色汽车在portrait.png中，将平淡的背景替换为日落山景在landscape.jpg中，将现代建筑替换为维多利亚时代的建筑，同时保持相同的氛围
放大
放大profile-pic.jpg以获得更好的分辨率放大product-photo.png使其适合打印
如果输出仍然不够好，您可以再次放大：
尝试以更高的质量再次放大
控制草图
将sketch.png转换为儿童书籍的彩色插图将wireframe.jpg转换为现代建筑设计的详细3D渲染
控制风格
根据参考图像的风格生成图像
控制结构
在保持参考图像结构的同时生成图像
替换背景并重新照明
将我刚刚生成的图像的背景替换为日落山景
搜索并重新着色
在我的最后一张图像中，将红色汽车改为蓝色
设置
元数据记录
服务器可以保存图像生成请求的元数据，以帮助跟踪和故障排除。
| 环境变量 | 描述 | 必需 | 默认值 |
|---|---|---|---|
SAVE_METADATA | 保存成功的图像生成元数据 | N | true |
SAVE_METADATA_FAILED | 保存失败的图像生成元数据 | N | false |
启用后，与生成图像同名的.txt文件将在同一目录下创建。该文件包含：
- 请求的时间戳
- 所有请求参数（提示、模型、样式预设等）
- 响应信息（成功状态、生成时间）
如果启用了SAVE_METADATA_FAILED，则也会为失败的请求创建此文件。
速查表
| 环境变量 | 描述 | 必需 | 默认值 | 示例 |
|---|---|---|---|---|
STABILITY_AI_API_KEY | 您的Stability AI API密钥。获取一个在platform.stability.ai | Y | N/A | sk-1234567890 |
IMAGE_STORAGE_DIRECTORY | 存储生成图像的目录 | N | /tmp/tadasant-mcp-server-stability-ai 或 C:\\Windows\\Temp\\mcp-server-stability-ai | /Users/admin/Downloads/stability-ai-images (Mac OS/Linux), C:\\Users\\Admin\\Downloads\\stability-ai-images (Windows) |
SAVE_METADATA | 保存成功的图像生成元数据 | N | true | true 或 false |
SAVE_METADATA_FAILED | 保存失败的图像生成元数据 | N | true | true 或 false |
GCS_PROJECT_ID | 存储图像的Google Cloud项目ID | N (Y 如果使用SSE) | N/A | your-project-id |
GCS_CLIENT_EMAIL | 存储图像的Google Cloud服务账户客户端电子邮件 | N (Y 如果使用SSE) | N/A | your-service-account@project.iam.gserviceaccount.com |
GCS_PRIVATE_KEY | 存储图像的Google Cloud服务账户私钥 | N (Y 如果使用SSE) | N/A | -----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n |
GCS_BUCKET_NAME | 存储图像的Google Cloud存储桶名称 | N (Y 如果使用SSE) | N/A | your-bucket-name |
Claude桌面
如果您喜欢视频教程，这里有一个快速教程。
在您的机器上创建一个文件夹目录来存储生成/修改的图像。一些选项：
/Users/<用户名>/Downloads/stability-ai-images/Users/<用户名>/Library/Application Support/Claude/mcp-server-stability-ai/images
确保您拥有来自Stability AI的API密钥。
然后继续进行您首选的服务器配置方法。如果您是第一次使用MCP服务器，您需要确保安装了Claude桌面应用程序并遵循官方MCP设置说明。
手动设置
您需要在机器上安装Node.js，以便可以在终端中运行npx命令。如果没有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桌面，您应该已经准备好使用了：
<img src="https://github.com/tadasant/mcp-server-stability-ai/blob/main/images/claude-1.png" width="500" alt="Claude第一张图片"> <img src="https://github.com/tadasant/mcp-server-stability-ai/blob/main/images/claude-2.png" width="500" alt="Claude第二张图片">通过Smithery安装
要通过Smithery自动安装到Claude桌面：
npx @smithery/cli install mcp-server-stability-ai --client claude
SSE模式
此服务器可以选择通过以下命令启动SSE模式：
npx mcp-server-stability-ai -y --sse
此模式适用于打算通过HTTP部署此服务器供第三方使用的情况。
您需要设置GCS_PROJECT_ID、GCS_CLIENT_EMAIL、GCS_BUCKET_NAME和GCS_PRIVATE_KEY环境变量，因为服务器会将图像文件存储在Google Cloud Storage中，而不是其本地文件系统中。
请注意，多租户方案非常简单且不安全：它使用请求者的IP地址来分割用于存储图像的GCS前缀，并使所有图像公开访问，以便能够将其传递回MCP客户端。因此，理论上，如果有人知道您的IP地址和您生成的文件名，他们可以通过猜测URL来访问您的图像。
发展路线图
最近完成：
- ✅ 添加了对Stable Diffusion 3.5模型的支持
- ✅ 添加了对Stable Image Ultra的支持
- ✅ 添加了图像生成请求的元数据记录
即将推出；欢迎PR！详情见CONTRIBUTING.md。
inpaint- 更精确的搜索并替换功能版本，需要管理一个掩码来定义要替换的区域。- 基础图像操作（裁剪、旋转、调整大小等）：可能作为独立的MCP服务器
- 将一张图像中的内容填入另一张图像的能力。似乎无法通过Stability API实现；可能需要另一个MCP服务器调用不同的API来实现。
- 专门用于图像操作的MCP客户端
贡献
欢迎外部贡献！详情见CONTRIBUTING.md。
也请随时提出问题或功能请求；很高兴看到人们如何使用这个工具以及如何改进它。