Stability AI MCP Server

Stability AI MCP Server

还没听说MCP吗？保持最新状态的最简单方法是阅读我们的 PulseMCP每周通讯.

______________________________________________________________________

这是一个MCP(模型上下文协议)服务器将MCP客户端与 稳定性AI的最新和最强大的稳定扩散图像操作功能：生成、编辑、升级等。

Stability AI是领先的AI模型提供商，该服务器直接连接到其 托管REST API。你需要注册一个 来自stability.ai的API密钥 开始吧。

他们免费提供25个学分。之后， 现收现付定价 非常合理：0.01美元/学分，其中3个学分可以让你在他们的Core模型上生成图像。所以100张高质量的照片只需3美元。

该项目与Stability AI没有正式关联。

演示视频，这里有一个预告片：

目录

• 亮点
• 能力
• 使用技巧
• 例子
• 设置

- 备忘单 - 克劳德桌面 - 手动设置

亮点

无学习曲线：此服务器旨在使用合理的默认值，并为与生成和操作图像文件相关的最常见操作提供简单、流畅的用户体验。你不需要技术或了解任何关于图像模型的知识就能有效地使用它。

链条操纵：您可以生成图像，然后替换其中的项目，然后删除背景。…一切都在克劳德的一次谈话中。

最小配置：您需要开始的只是一个Stability AI API密钥。为此设置环境变量和存储输出图像的本地目录路径，您就可以开始了。

利用一流的图像模型：Stability AI是通过API曝光的图像模型的领先提供商。使用此服务器将它们集成到Claude或另一个MCP客户端中，这比在ChatGPT中使用DALL-E模型的体验要好得多。

能力

此服务器是在macOS上使用Claude Desktop构建和测试的。它也应该与其他MCP客户端一起工作。

使用技巧

• 所有处理后的图像都会自动保存到 IMAGE_STORAGE_DIRECTORY，打开预览，并作为资源提供
• 做 _不_ 尝试将图像文件复制/粘贴或上传到Claude。Claude不会在任何地方存储图像，因此我们无法使用MCP服务器。它们必须“上传”（保存到） IMAGE_STORAGE_DIRECTORY 然后它们将显示为聊天中可用的资源。
• 你可以使用预装的提示，而不是写自己的措辞：

例子

生成图像

1. Generate an image of a cat
2. Generate a photorealistic image of a cat in a cyberpunk city, neon lights reflecting off its fur, 16:9 aspect ratio
3. Generate a detailed digital art piece of a cat wearing a space suit floating through a colorful nebula, style preset: digital-art, aspect ratio: 21:9

使用SD3.5生成图像

1. Generate an image of a woman with cybernetic wolf ears using the SD3.5 model, with the "neon-punk" style preset
2. Generate an image of a futuristic city using the SD3.5 Large Turbo model, with aspect ratio 16:9
3. Generate an image of an astronaut on mars using the SD3.5 Large model, with cfg scale 7.5, "analog-film" style preset, and seed 42

删除背景

1. Remove the background from the image I just generated
2. Remove the background from product-photo.jpg to prepare it for my e-commerce site
3. Remove the background from group-photo.png so I can composite it with another image

Outpaint（取消裁剪）

1. Extend vacation-photo.jpg 500 pixels to the right to include more of the beach
2. Extend family-portrait.png 300 pixels up to show more of the mountains, and 200 pixels right to include more landscape
3. Extend artwork.png in all directions to create a wider fantasy forest scene that matches the original environment

搜索和替换

1. In my last image, replace the red car with a blue car
2. In portrait.png, replace the plain background with a sunset over mountains
3. In landscape.jpg, replace the modern buildings with victorian-era architecture while maintaining the same atmosphere

高档

1. Upscale profile-pic.jpg for better resolution
2. Upscale product-photo.png to make it print-ready

然后，如果输出仍然不够好，你可以再次升级：

1. Try again with better quality

控制示意图

1. Transform sketch.png into a colored illustration for a children's book
2. Convert wireframe.jpg into a detailed 3D render for a modern architectural visualization

控件样式

1. Generate an image in the style of the reference image

控制结构

1. Generate an image while maintaining the structure of the reference image

替换背景和重新照明

1. Replace the background of the image I just generated with a sunset over mountains

搜索和重新着色

1. In my last image, make the red car be blue instead

设置

元数据日志记录

服务器可以保存图像生成请求中的元数据，以帮助跟踪和排除故障。

当启用时，a .txt 将在同一目录中创建与生成的图像同名的文件。此文件包含：

• 请求的时间戳
• 所有请求参数（提示、型号、样式预设等）
• 响应信息（成功状态、生成时间）

如果出现以下情况，也将为失败的请求创建此文件 SAVE_METADATA_FAILED 已启用。

备忘单

克劳德桌面

如果你喜欢视频教程，这里 快速的.

在计算机上的某个位置创建一个文件夹目录来存储生成/修改的图像。一些选项：

• /Users//Downloads/stability-ai-images
• /Users//Library/Application Support/Claude/mcp-server-stability-ai/images

确保你有一个 来自Stability AI的API密钥.

手动设置

你需要Node在你的机器上工作，这样你才能运行 npx 您终端中的命令。如果你没有Node，你可以从以下位置安装它 .

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： %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 Desktop，您应该已经准备好了：

通过Smithery安装

通过以下方式自动安装Claude Desktop 史密瑟里:

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的支持
• ✅ 为图像生成请求添加了元数据日志记录

这些很快就会到来；但欢迎公关！看 贡献.md.

• inpaint -更精确的版本 search-and-x 功能，需要将掩码定义为要替换的区域。
• 基础图像操作（裁剪、旋转、调整大小等）：可能作为其自己的MCP服务器
• 能够将一个图像输入到另一个图像中。使用稳定性API似乎不可能；可能会希望另一个MCP服务器使用不同的API来实现这一点。
• 为图像处理定制的MCP客户端

贡献

欢迎外部捐款！看 贡献.md 了解更多详情。

也请随时提出问题或功能请求；喜欢看到人们如何使用它，以及如何让它变得更好。