基于火山引擎和Dream AI的即时梦想AI图像生成MCP服务

基于Volcano Engine和Dream AI的图像生成MCP服务。

特性

• 使用Volcano Engine的Dreaming AI API生成高质量图像
• 支持多种图像比例：4:3, 3:4, 16:9, 9:16
• 标准化的MCP接口，兼容各种MCP客户端
• 环境变量配置，安全便捷

安装依赖

cd jimengpic-mcp
npm install

编译项目

npm run build

环境变量配置

设置以下环境变量：

export JIMENG_ACCESS_KEY="你的火山引擎AccessKey"
export JIMENG_SECRET_KEY="你的火山引擎SecretKey"

获取API密钥

1. 访问火山引擎控制台
2. 登录后进入“Dreaming AI”产品页面并激活服务（可以选择免费试用）
3. 在“访问控制”页面创建访问密钥，并获取Access Key和Secret Key
4. 确保账户已激活并具有使用Dreaming AI生成图像的相关权限和策略

注意： 根据官方文档，请确保正确使用req_key参数值 jimeng_high_aes_general_v21_L

使用说明

直接运行

node build/index.js

作为MCP服务器

在MCP客户端（如Claude Desktop、cursor等）中配置此服务：

{
  "mcpServers": {
    "jimengpic": {
      "command": "node",
      "args": ["/path/to/jimengpic-mcp/build/index.js"],
      "env": {
        "JIMENG_ACCESS_KEY": "你的AccessKey",
        "JIMENG_SECRET_KEY": "你的SecretKey"
      }
    }
  }
}

API接口

generate-image

用户在生成图像时使用的工具。

参数

• text (字符串)：用户需要显示在图像上的文本
• illustration (字符串)：根据用户想要显示的文本提取3-5个可用于图像装饰的插图元素关键词
• color (字符串)：图像背景的主要色调
• ratio (枚举)：图像比例，支持以下选项：
  • "4:3": 512×384
  • "3:4": 384×512
  • "16:9": 512×288
  • "9:16": 288×512

生成提示词规则： 工具会自动将输入参数组合成如下格式的提示词：

字体设计：“{text}”，黑色字体，斜体，带阴影。干净的背景，白色到{color}渐变。点缀浅灰色、半透明{illustration}等元素插图做配饰插画。

返回：

• 成功时返回图像URL及详细信息
• 失败时返回错误消息

使用示例

// 在MCP客户端中调用
const result = await mcp.callTool("generate-image", {
  text: "新年快乐",
  illustration: "烟花, 灯笼, 祥云, 星星, 礼花",
  color: "红色",
  ratio: "4:3"
});

项目结构

jimengpic-mcp/
├── src/
│   └── index.ts          # 主服务文件
├── build/                # 编译输出目录
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript配置
└── README.md            # 项目说明

注意事项

1. 确保网络连接正常且能够访问火山引擎API
2. API调用会消耗积分，请注意使用量
3. 生成的图像URL有时效性，建议及时下载保存
4. 请遵守火山引擎的使用条款和Zhimeng AI的内容政策

故障排除

常见错误

1. 环境变量未设置确保正确设置了ACCESS_KEY和SECRET_KEY
2. 网络连接问题检查网络连接和防火墙设置
3. API配额不足检查火山引擎账户余额和API调用次数
4. 提示词不合规确保提示词符合内容安全标准

调试方法

在运行时添加调试信息：

DEBUG=* node build/index.js

许可证

ISC许可证