Stability AI MCP Server

还不了解 MCP？想及时了解相关动态，最简单的方法就是阅读我们在 PulseMCP 上发布的每周简报。

---

这是一个 MCP（模型上下文协议）服务，可将 MCP 客户端与 Stability AI 最新、最强大的 Stable Diffusion 图像处理功能集成起来：生成、编辑、放大图像等。

Stability AI 是领先的 AI 模型提供商，本服务可直接连接其托管的 REST API。开始使用前，你需要注册并获取 stability.ai 的 API 密钥。

Stability AI 提供 25 个免费额度。之后采用按需付费的定价方式，价格非常合理：每个额度 $0.01，使用其 Core 模型生成一张图像需要 3 个额度。因此，生成 100 张高质量图像只需 $3。

本项目与 Stability AI 没有官方关联。

演示视频，以及以下预告：

目录

• 亮点
• 功能
• 使用技巧
• 示例
• 设置
  • 速查表
  • Claude Desktop
    • 手动设置

亮点

无需学习成本：本服务采用合理的默认设置，为生成和处理图像文件的常见操作提供简单、流畅的使用体验。你无需具备技术背景，也无需了解图像模型，就能轻松使用。

串联处理操作：你可以生成图像、替换其中的某个物体，再移除背景……所有操作都能在一次 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，之后它们便会作为资源显示在聊天中。
• 你可以使用预先加载的提示词，而不必自己编写：

示例

生成图像

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

扩展画布（取消裁剪）

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

设置

元数据记录

服务可以保存图像生成请求的元数据，以便跟踪和排查问题。

环境变量	描述	必填	默认值
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 OR 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 or false
SAVE_METADATA_FAILED	保存生成图像失败时的元数据	N	true	true or false
GCS_PROJECT_ID	用于存储图像的 Google Cloud 项目 ID	N (Y if using SSE)	N/A	your-project-id
GCS_CLIENT_EMAIL	用于存储图像的 Google Cloud 服务账号客户端邮箱	N (Y if using SSE)	N/A	[email protected]
GCS_PRIVATE_KEY	用于存储图像的 Google Cloud 服务账号私钥	N (Y if using SSE)	N/A	-----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n
GCS_BUCKET_NAME	用于存储图像的 Google Cloud Storage 存储桶名称	N (Y if using SSE)	N/A	your-bucket-name

Claude Desktop

如果你更喜欢视频教程，可以观看这个简短教程。

在你的设备上创建一个文件夹，用于存放生成或修改后的图像。可以选择以下路径：

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

并确保你拥有一个 Stability AI API 密钥。

然后，选择下面你喜欢的方式来配置服务。如果这是你第一次使用 MCP 服务，请确保已安装 Claude Desktop 应用程序，并按照 MCP 官方设置说明操作。

手动设置

你需要在设备上安装并运行 Node，才能在终端中运行 npx 命令。如果尚未安装 Node，可以从 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 Desktop，即可开始使用：

通过 Smithery 安装

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

以下功能即将推出；欢迎提交 PR！请参阅 CONTRIBUTING.md。

• inpaint - search-and-x 功能的更精确版本，需要管理蒙版以定义要替换的区域。
• 基础图像处理（裁剪、旋转、调整大小等）：可能会作为独立的 MCP 服务推出
• 将一张图像修补到另一张图像中的功能。Stability API 似乎无法实现；可能需要另一个调用不同 API 的 MCP 服务来完成。
• 专为图像处理定制的 MCP 客户端

贡献

欢迎外部贡献！详情请参阅 CONTRIBUTING.md。

也欢迎提交问题或功能请求；我们很乐于了解大家如何使用此项目，以及如何改进它。