百炼图像生成MCP(修改版）
一个Model Context Protocol服务器，提供使用阿里云百炼平台的图像生成和编辑功能。支持多种模型、分辨率及自定义参数。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"bailian-image": {
"args": [
"--from",
"bailian-imagegen-mcp-edited",
"bailian-mcp-server"
],
"command": "uvx",
"env": {
"DASHSCOPE_API_KEY": "sk-your-real-api-key"
}
}
}
}该服务需要配置环境变量：DASHSCOPE_API_KEY
可用工具 （3 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
list_image_models
获取可用的阿里云百炼图像模型列表及其说明 Returns: 包含模型名称、简介和输出规格的详细文本
该工具无需必填参数，直接调用即可
generate_image 6 个参数 需填 1 项
调用阿里云百炼生图API生成图像 (同步模式) Args: prompt: 正向提示词，用来描述生成图像中期望包含的元素和视觉特点 model: 指定使用的图像生成模型，默认为 "z-image-turbo"。 可用模型包括: "qwen-image-max", "qwen-image-plus", "z-image-turbo", "wan2.6-image", "wan2.2-t2i-flash", "wan2.2-t2i-plus" 等。 详情请调用 list_image_models 工具查看。 size: 输出图像的分辨率，格式为宽*高。默认为 "1024*1024"。 不同模型支持的分辨率范围不同，请参考 list_image_models 的说明。 prompt_extend: 是否开启prompt智能改写 watermark: 是否添加水印标识 negative_prompt: 反向提示词，用来描述不希望在画面中看到的内容 Returns: 包含图片URL的JSON格式字符串
必填参数：prompt
image_edit_generation 4 个参数 需填 2 项
调用阿里云百炼编辑图片API生成图像 (同步模式) :param prompt: 正向提示词 :param image: 输入图像的URL或Base64 :param model: 指定使用的图像编辑模型，默认为 "qwen-image-edit-plus" :param negative_prompt: 反向提示词 Returns: 包含生成的图像URL的JSON
必填参数：prompt、image
服务介绍
阿里云百炼生图 MCP 服务器
一个 Model Context Protocol 服务器，提供阿里云百炼平台的图像生成和编辑功能。该服务器使LLM能够调用阿里云百炼API来生成、编辑图像，支持多种图像分辨率、多模型选择（Qwen, Z-Image, Wan系列）和自定义参数。
最新功能：
- 全异步架构：完美适配 MCP SSE 协议，不会阻塞服务器心跳。
- 直接返回结果：无需二次查询，生图请求直接返回图片 URL。
- 多模型支持：支持 Qwen-Image, Wan (万相) 等最新模型。
可用工具
generate_image - 生成图像 (同步返回)
使用文本提示词生成图像，请求等待生成完成后直接返回图片链接。
- 必需:
prompt - 可选:
model(默认 z-image-turbo),size(默认 1024*1024),prompt_extend,watermark,negative_prompt
image_edit_generation - 编辑图像 (同步返回)
基于现有图像和文本提示生成新的编辑版本。
- 必需:
prompt,image(URL) - 可选:
model(默认 qwen-image-edit-plus),negative_prompt
list_image_models - 获取模型列表
返回支持的图像模型列表及其详细说明（包括简介、分辨率限制等）。
快速开始
方式 1: 使用 uvx 直接运行 (推荐)
如果已安装 uv，无需下载代码即可运行：
# 需设置环境变量 DASHSCOPE_API_KEY
uvx --from bailian-imagegen-mcp-edited bailian-mcp-server
方式 2: 本地安装运行
# 安装包
pip install bailian-imagegen-mcp-edited
# 运行
bailian-mcp-server
配置指南
身份验证
您需要阿里云百炼平台的 API 密钥。
export DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
1. Claude.app 配置 (桌面版)
编辑配置文件 (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json)：
{
"mcpServers": {
"bailian-image": {
"command": "uvx",
"args": [
"--from",
"bailian-imagegen-mcp-edited",
"bailian-mcp-server"
],
"env": {
"DASHSCOPE_API_KEY": "sk-your-real-api-key"
}
}
}
}
2. 魔搭社区 (ModelScope) 部署配置
如果您在魔搭 MCP 广场创建服务，请使用以下配置：
- 托管类型: 可托管部署
- 服务配置:
{ "mcpServers": { "bailian-image": { "command": "uvx", "args": [ "--from", "bailian-imagegen-mcp-edited", "bailian-mcp-server" ], "env": { "DASHSCOPE_API_KEY": "sk-your-real-api-key" } } } }
3. VS Code 配置 (Cline/Roo 等插件)
在项目根目录创建 .vscode/mcp.json：
{
"mcp": {
"servers": {
"bailian-image": {
"command": "uvx",
"args": [
"--from",
"bailian-imagegen-mcp-edited",
"bailian-mcp-server"
],
"env": {
"DASHSCOPE_API_KEY": "sk-your-real-api-key"
}
}
}
}
}
开发与调试
如果您从源码运行：
# 安装依赖
pip install -e .
# Stdio 模式运行
python bailian_mcpserver.py
# HTTP/SSE 模式运行 (用于远程部署调试)
python bailian_mcpserver.py --http
调试
使用 MCP Inspector 进行调试：
npx @modelcontextprotocol/inspector python bailian_mcpserver.py
许可证
MIT License
