魔搭图像生成 MCP 服务


这是一个用于 Claude Code、Gemini CLI、Qwen Code 等 AI 编辑器的 MCP (Model Context Protocol) 服务器，集成了魔搭 ModelScope 的图像生成能力。

功能特性

- 🎨 使用魔搭平台的 FLUX 等先进图像生成模型
- 🔄 支持异步任务处理，自动轮询生成状态
- 💾 自动保存图片到用户的"下载"文件夹，支持自定义路径
- 🖼️ 在 AI 编辑器中直接显示生成的图片
- 🔍 智能检测图片格式 (PNG/JPEG/GIF/WebP)
- ⏰ 带时间戳的文件命名，避免覆盖
- 📦 通过 npm 安装，无需克隆仓库或配置路径

安装

$3

``bash
npm install -g moda-image-mcp
`

$3

直接在配置中使用 npx moda-image-mcp，会自动下载并运行。

配置

$3

1. 访问 魔搭 ModelScope 注册账号
2. 在个人设置中获取 API Key

$3

在 ~/.cursor/mcp.json 或项目根目录的 .mcp.json 中添加：

`json
{
"mcpServers": {
"moda-image": {
"command": "npx",
"args": ["-y", "moda-image-mcp"],
"env": {
"MODA_API_KEY": "你的魔搭API密钥"
}
}
}
}
`

$3

在 ~/.gemini/settings.json 中添加：

`json
{
"mcpServers": {
"moda-image": {
"command": "npx",
"args": ["-y", "moda-image-mcp"],
"env": {
"MODA_API_KEY": "你的魔搭API密钥"
}
}
}
}
`

$3

在 Continue 配置文件中添加：

`json
{
"mcpServers": {
"moda-image": {
"command": "npx",
"args": ["-y", "moda-image-mcp"],
"env": {
"MODA_API_KEY": "你的魔搭API密钥"
}
}
}
}
`

$3

可以直接使用 moda-image-mcp 命令：

`json
{
"mcpServers": {
"moda-image": {
"command": "moda-image-mcp",
"env": {
"MODA_API_KEY": "你的魔搭API密钥"
}
}
}
}
`

使用方法

配置完成后，在 AI 编辑器中直接使用自然语言请求生成图片：

$3

`
生成一张金色小猫的图片
`

图片将保存到默认的"下载"文件夹。

$3

`
生成一张蓝色汽车的图片，保存到 ~/Desktop/my_car.jpg
`

$3

`
使用 Qwen/Qwen-Image 模型生成一幅山水画
`

可用工具

$3

描述: 使用魔搭模型生成图片

参数:
| 参数 | 类型 | 必需 | 描述 |
|------|------|------|------|
| prompt | string | ✅ | 图片生成的文本描述，支持中英文 |
| model | string | ❌ | 模型ID，默认为 "Qwen/Qwen-Image" |
| save_path | string | ❌ | 保存路径，可以是目录或完整文件路径 |

返回:
- 生成结果的文本说明
- 生成的图片（base64编码，可直接在编辑器中显示）

支持的模型

- Qwen/Qwen-Image (默认) - FLUX 高质量图像生成
- 其他魔搭平台支持的图像生成模型（查看 魔搭模型库）

故障排除

$3

1. 服务未加载
- 重启 AI 编辑器
- 检查配置文件路径是否正确
- 确认 Node.js 版本 >= 18

2. API 错误
- 验证 API 密钥有效性
- 检查网络连接
- 查看魔搭平台账户余额

3. 图片生成超时
- 图像生成通常需要 10-60 秒
- 检查网络稳定性

$3

手动运行服务器查看日志：

`bash
MODA_API_KEY="your-key" npx moda-image-mcp
`

技术特性

- MCP SDK: 使用官方 @modelcontextprotocol/sdk
- 异步处理: 支持长时间运行的图片生成任务
- 智能格式检测: 通过文件头自动识别图片格式
- 图片处理: 使用 sharp 库进行高质量图片处理
- TypeScript: 完整的类型定义支持

开发

`bash


克隆仓库

git clone https://github.com/a11995910/Moda-MCP--image.git
cd MODA_MCP

安装依赖

npm install

开发模式

npm run dev

构建

npm run build

测试运行

MODA_API_KEY="your-key" npm start
``

许可证

MIT License - 详见 LICENSE 文件

注意事项

- ⚠️ 需要有效的魔搭 API 密钥
- ⏱️ 图像生成是异步过程，通常需要 10-60 秒
- 🔒 请妥善保管 API 密钥，不要提交到公开仓库