ModelScope Image Generation MCP Server

一个用于魔搭社区（ModelScope）文生图服务的 MCP（Model Context Protocol）服务器，使用 Qwen/Qwen-Image 模型，支持在 Claude Desktop 等 MCP 客户端中使用。

功能特性

• 🎨 使用魔搭社区的 Qwen/Qwen-Image 模型生成图片

• 🔄 同步生图体验：调用工具后自动等待生成完成

• ⚙️ 完整参数支持：正向/负向提示词、分辨率、种子、采样步数、引导系数等

• 📦 支持 npx 一键安装和运行

安装

方式 1: 使用 npx（推荐）

无需安装，直接在 Claude Desktop 配置中使用：

方式 2: 全局安装

配置示例：

方式 3: 本地开发

Claude Desktop 配置：

获取 API Key

1. 访问 魔搭社区

2. 登录账号

3. 进入个人中心获取 API Token (MODELSCOPE_SDK_TOKEN)

4. 将 Token 配置为环境变量 MODELSCOPE_API_KEY

使用示例

在 Claude Desktop 中，你可以直接使用自然语言调用生图功能：

基础用法

高级用法（指定详细参数）

支持的参数

本服务使用 Qwen/Qwen-Image 模型，支持以下参数：

• prompt (必需): 正向提示词（建议使用英文）

  • 最大长度：2000 字符

• negative_prompt (可选): 负向提示词

  • 最大长度：2000 字符

• size (可选): 图片分辨率

  • 范围：[64x64, 1664x1664]

  • 默认：1024x1024

• seed (可选): 随机种子，用于可重复生成

  • 范围：[0, 2^31-1]

• steps (可选): 采样步数

  • 范围：[1, 100]

• guidance (可选): 提示词引导系数

  • 范围：[1.5, 20]

• image_url (可选): 待编辑图片的 URL（用于图片编辑模式）

  • 要求：公网可访问

配置文件位置

Windows

macOS

Linux

开发

故障排除

提示 API Key 未设置

确保在 Claude Desktop 配置文件中正确设置了 MODELSCOPE_API_KEY 环境变量。

生成失败

• 检查模型 ID 是否正确

• 检查提示词长度是否超过 2000 字符

• 检查参数值是否在允许范围内

• 查看 Claude Desktop 的开发者工具控制台获取详细错误信息

npx 命令找不到

确保已安装 Node.js 18 或更高版本。

许可证

MIT

相关链接

• 魔搭社区

• Model Context Protocol

• Claude Desktop