关键词

图像生成图像编辑图像处理稳定扩散AI图像工具

Stability AI MCP 服务器使用说明

项目简介

Stability AI MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将 Stability AI 提供的强大的图像生成和编辑 API 集成到 MCP 生态系统中。通过此服务器，LLM 客户端（如 Claude）可以方便地调用 Stability AI 的图像处理工具，实现文本到图像生成、图像编辑、风格转换等多种功能。

主要功能点

  • 图像生成: 根据文本提示生成高质量图像，支持多种模型和风格预设。
  • 图像编辑: 提供图像背景移除、图像局部替换、图像外扩、图像风格迁移、图像结构控制等多种编辑工具。
  • 图像放大: 支持快速和高质量的图像分辨率提升，最高可达 4K 分辨率。
  • 资源管理: 自动保存和管理生成的图像资源，方便后续操作和引用。
  • Prompt 模板: 预置常用 Prompt 模板，简化用户操作，降低使用门槛。
  • 多传输协议支持: 支持 Stdio 和 SSE 传输协议，满足不同部署需求。

安装步骤

  1. 安装 Node.js: 确保您的机器上已安装 Node.js 运行时环境 (建议 v18 或更高版本)。您可以从 nodejs.org 下载并安装。
  2. 获取 Stability AI API 密钥: 访问 platform.stability.ai 注册并获取您的 Stability AI API 密钥。
  3. 配置环境变量:
    • 创建一个目录用于存储生成的图像，例如 '/Users/yourname/stability-ai-images' (macOS/Linux) 或 'C:\stability-ai-images' (Windows)。
    • 设置以下环境变量：
      • 'STABILITY_AI_API_KEY': 您的 Stability AI API 密钥。
      • 'IMAGE_STORAGE_DIRECTORY': 您创建的图像存储目录的路径。
    • 您可以通过多种方式设置环境变量，例如在终端中使用 'export' 命令 (macOS/Linux) 或 'set' 命令 (Windows)，或者在操作系统的高级系统设置中进行配置。
  4. 安装 MCP 服务器: 在终端中运行以下命令安装 'mcp-server-stability-ai'： 
    npx -y mcp-server-stability-ai
    或者，如果您希望使用 SSE 模式，请运行： 
    npx -y mcp-server-stability-ai --sse

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude），您需要提供以下 JSON 配置信息。请注意，以下配置信息仅供参考，您的 MCP 客户端可能需要您手动输入或从 JSON 文件中读取配置。请勿复制粘贴以下代码到终端或命令行。

{
  "mcpServers": {
    "stability-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-stability-ai"
      ],
      "env": {
        "STABILITY_AI_API_KEY": "YOUR_STABILITY_AI_API_KEY"
      }
      // "server name" (stability-ai):  MCP 服务器的名称，在客户端中用于标识和选择服务器。
      // "command" (npx):  用于启动 MCP 服务器的命令，通常是 Node.js 的 npx 命令。
      // "args" (["-y", "mcp-server-stability-ai"]):  传递给启动命令的参数，这里 "-y" 表示自动确认，"mcp-server-stability-ai" 是要执行的 npm 包。
      // "env" ({"STABILITY_AI_API_KEY": "YOUR_STABILITY_AI_API_KEY"}):  环境变量配置，您需要将 "YOUR_STABILITY_AI_API_KEY" 替换为您实际的 Stability AI API 密钥。
      //                                                请注意，实际使用时，API 密钥应该在操作系统环境变量中配置，而不是直接写在配置文件中，这里为了演示方便才写在这里。
    }
  }
}

重要提示:

  • 请务必将 'YOUR_STABILITY_AI_API_KEY' 替换为您在 Stability AI 平台获得的 API 密钥。
  • 如果您选择使用 SSE 模式启动服务器 ('npx -y mcp-server-stability-ai --sse')，则需要根据 SSE 模式的说明进行额外的 Google Cloud Storage (GCS) 配置。

基本使用方法

  1. 启动 MCP 服务器: 按照安装步骤中的命令启动 MCP 服务器。

  2. 配置 MCP 客户端: 将上述 JSON 配置信息添加到您的 MCP 客户端配置中（例如 Claude Desktop 的 'claude_desktop_config.json' 文件），并确保客户端已正确连接到 MCP 服务器。

  3. 使用 LLM 客户端与 MCP 服务器交互: 在 LLM 客户端中，您可以像与普通 LLM 对话一样，使用自然语言指令来调用 MCP 服务器提供的图像处理工具。例如：

    • 'Generate an image of a futuristic city' (生成未来城市图像)
    • 'Remove the background from the image I just generated' (移除上一个生成图像的背景)
    • 'Upscale profile-pic.jpg for better resolution' (放大 profile-pic.jpg 图像分辨率)
    • 'In my last image, replace the red car with a blue car' (将上一个图像中的红车替换为蓝车)

    您还可以使用预置的 Prompt 模板来简化操作。

  4. 查看和管理图像资源: 生成的图像会自动保存到您配置的 'IMAGE_STORAGE_DIRECTORY' 目录中，并可以通过 'list-resources' 工具在 MCP 客户端中查看和引用。

请参考仓库的 README.md 文件和示例视频以获取更详细的使用指南和操作演示。

信息

分类

AI与计算

访问项目