ModelScope text-to-image MCP server for Claude Desktop and other MCP clients
npm install mcp-modelscope-image一个用于魔搭社区（ModelScope）文生图服务的 MCP（Model Context Protocol）服务器，使用 Qwen/Qwen-Image 模型，支持在 Claude Desktop 等 MCP 客户端中使用。
- 🎨 使用魔搭社区的 Qwen/Qwen-Image 模型生成图片
- 🔄 同步生图体验：调用工具后自动等待生成完成
- ⚙️ 完整参数支持：正向/负向提示词、分辨率、种子、采样步数、引导系数等
- 📦 支持 npx 一键安装和运行
无需安装，直接在 Claude Desktop 配置中使用：
``json`
{
"mcpServers": {
"modelscope-image": {
"command": "npx",
"args": ["-y", "mcp-modelscope-image"],
"env": {
"MODELSCOPE_API_KEY": "your-api-key-here"
}
}
}
}
`bash`
npm install -g mcp-modelscope-image
配置示例：
`json`
{
"mcpServers": {
"modelscope-image": {
"command": "mcp-modelscope-image",
"env": {
"MODELSCOPE_API_KEY": "your-api-key-here"
}
}
}
}
`bash克隆或下载项目
cd mcp-local-modelscope-image
Claude Desktop 配置：
json
{
"mcpServers": {
"modelscope-image": {
"command": "node",
"args": ["E:\\workspace\\jasion\\jq-mcp\\mcp-local-modelscope-image\\dist\\index.js"],
"env": {
"MODELSCOPE_API_KEY": "your-api-key-here"
}
}
}
}
`获取 API Key
1. 访问 魔搭社区
2. 登录账号
3. 进入个人中心获取 API Token (MODELSCOPE_SDK_TOKEN)
4. 将 Token 配置为环境变量
使用示例
在 Claude Desktop 中，你可以直接使用自然语言调用生图功能：
$3
请生成一张图片：一只金色的猫咪在阳光下玩耍
$3
生成图片：
- 提示词：A mysterious girl walking down the corridor, cinematic lighting, highly detailed
- 负向提示词：lowres, bad anatomy, text, watermark
- 分辨率：1024x1024
- 采样步数：30
- 引导系数：7.5
- 随机种子：12345
支持的参数
本服务使用 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（用于图片编辑模式）
- 要求：公网可访问
配置文件位置
$3
%APPDATA%\Claude\claude_desktop_config.json
$3
~/Library/Application Support/Claude/claude_desktop_config.json
$3
~/.config/Claude/claude_desktop_config.json
开发
bash
安装依赖
npm install开发模式（监听文件变化）
npm run watch构建
npm run build
`故障排除
$3
确保在 Claude Desktop 配置文件中正确设置了 MIT