JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 42
  • Score
    100M100P100Q94230F
  • License MIT

MCP服务器项目，集成即梦AI图像生成

Package Exports

  • jimeng-web-mcp
  • jimeng-web-mcp/server

Readme

JiMeng Web MCP 服务器

使用TypeScript实现的Model Context Protocol (MCP) 服务器项目，集成了即梦AI图像生成服务，通过逆向工程直接调用即梦官方API。

🎯 最新更新 (v1.12.0)

重大架构优化 - 采用组合模式重构，代码量减少74.6%：

  • ✅ 5,268行代码 → 1,335行代码 (净减少3,933行)
  • ✅ 从复杂继承改为清晰的组合模式
  • ✅ 100%向后兼容，无需修改现有代码
  • ✅ 更快的构建速度和更好的性能
  • ✅ 更易于理解和维护的代码结构

详见 CHANGELOG.md 获取完整更新日志

功能

  • 基于TypeScript构建
  • 使用tsup作为构建工具
  • 实现了MCP协议，支持标准的stdio通信
  • 直接调用即梦AI图像生成服务，无需第三方API
  • 提供多种即梦模型的图像生成工具
  • 支持继续生成功能：当需要生成超过4张图片时自动触发，一次性返回所有图片
  • 支持多种图像参数调整，如尺寸、精细度、负面提示词等
  • 支持多参考图混合生成（通过filePath参数，支持本地图片和网络图片）
  • 支持视频生成，包括智能多帧模式和传统首尾帧模式
  • 支持视频后处理：帧插值、超分辨率、音效生成
  • 现代化架构：组合模式设计，代码简洁高效

安装

通过npx自动安装（推荐）

零安装配置 - 只需在Claude Desktop中配置MCP，无需手动安装：

{
  "mcpServers": {
    "jimeng-web-mcp": {
      "command": "npx",
      "args": ["-y", "--package=jimeng-web-mcp", "jimeng-web-mcp"],
      "env": {
        "JIMENG_API_TOKEN": "your_jimeng_session_id_here"
      }
    }
  }
}

优势：

  • ✅ 完全自动安装，无需手动步骤
  • ✅ 始终获取最新版本
  • ✅ 跨平台兼容
  • ✅ 零维护成本

通过MCPHub安装

MCPHub是新一代MCP服务器管理平台，提供更好的安装体验：

# 安装MCPHub CLI
npm install -g mcphub

# 通过MCPHub安装jimeng-web-mcp
mcphub install jimeng-web-mcp

# 或者一键安装并配置到Claude Desktop
mcphub install jimeng-web-mcp --client claude

手动安装

# 使用yarn安装依赖
yarn install

# 或使用npm安装依赖
npm install

环境配置

npx自动安装配置

使用npx方式无需额外配置，已包含在MCP配置中。只需获取JIMENG_API_TOKEN（见下方说明）。

MCPHub配置

使用MCPHub安装后，只需设置环境变量：

# 设置JiMeng API Token
mcphub config set JIMENG_API_TOKEN your_jimeng_session_id_here

# 查看配置状态
mcphub status jimeng-web-mcp

手动安装配置

对于手动安装，您可以直接配置Claude Desktop：

{
  "mcpServers": {
    "jimeng-web-mcp": {
      "command": "node",
      "args": ["path/to/jimeng-web-mcp/lib/index.js"],
      "env": {
        "JIMENG_API_TOKEN": "your_jimeng_session_id_here"
      }
    }
  }
}

获取JIMENG_API_TOKEN

  1. 访问 即梦AI官网 并登录账号
  2. 按F12打开浏览器开发者工具
  3. 在Application > Cookies中找到sessionid的值
  4. 将找到的sessionid值配置为JIMENG_API_TOKEN环境变量

开发

# 开发模式运行
yarn dev

# 使用nodemon开发并自动重启
yarn start:dev

构建

# 构建项目
yarn build

运行

# 启动服务器
yarn start

# 测试MCP服务器
yarn test

Claude Desktop 配置示例

推荐配置（npx自动安装）

零配置安装 - 推荐使用此配置，无需手动安装任何依赖：

{
  "mcpServers": {
    "jimeng-web-mcp": {
      "command": "npx",
      "args": ["-y", "--package=jimeng-web-mcp", "jimeng-web-mcp"],
      "env": {
        "JIMENG_API_TOKEN": "your_jimeng_session_id_here"
      }
    }
  }
}

手动安装配置

如果您选择手动安装，可以使用以下配置：

{
  "mcpServers": {
    "jimeng-web-mcp": {
      "command": "node",
      "args": ["/path/to/jimeng-web-mcp/lib/index.js"],
      "env": {
        "JIMENG_API_TOKEN": "your_jimeng_session_id_here"
      }
    }
  }
}

即梦AI图像生成

本MCP服务器直接调用即梦AI图像生成API，提供图像生成工具：

generateImage - 提交图像生成请求并返回图像URL列表，支持继续生成功能

  • 参数：
    • prompt：生成图像的文本描述（必填）提示：在提示词中明确指定需要多张图片可触发继续生成
    • filePath：多参考图路径数组，支持本地图片和网络URL（可选）
    • model：模型名称，可选值: jimeng-4.0, jimeng-3.0, jimeng-2.1, jimeng-2.0-pro, jimeng-2.0, jimeng-1.4, jimeng-xl-pro（可选，默认为jimeng-4.0）
    • aspectRatio：图像宽高比，支持auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 21:9（可选，默认auto）
    • sample_strength：参考图影响强度，默认值：0.5，范围0-1（可选）
    • reference_strength：多参考图独立强度数组，与filePath对应（可选）
    • negative_prompt：反向提示词，告诉模型不要生成什么内容（可选）

注意：

  • filePath 支持本地绝对/相对路径和图片URL。
  • 若指定 filePath，将自动进入图片混合/参考图生成模式，底层模型自动切换为 jimeng-2.0-pro。
  • 网络图片需保证可公开访问。

继续生成功能 ✨

当您在提示词中明确要求生成多张图片时（如"生成8张不同角度的图片"、"制作10个阶段的系列图"），系统会自动检测并触发继续生成：

  • 自动触发：当API返回total_image_count > 4时自动激活
  • 单次执行：只发送一次继续生成请求，避免重复调用
  • 完整等待：等待所有图片生成完成后一次性返回
  • 无缝体验：对用户透明，无需额外配置

示例提示词：

生成8张不同角度的可爱橘猫：正面、侧面、背面、俯视、仰视、左卧、右玩、奔跑
创作12种风格的头像：写实、卡通、水彩、油画、素描、3D、像素、日系、欧美、国画、波普、科幻

多参考图混合生成功能

如需基于图片进行混合生成，只需传入filePath参数（支持本地路径或图片URL），即可实现图片风格融合、参考图生成等高级玩法。

示例：

// 参考图片混合生成
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "梵高风格的猫",
    filePath: "./test.png", // 本地图片路径
    sample_strength: 0.6
  }
});

或

// 使用网络图片作为参考
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "未来城市",
    filePath: "https://example.com/your-image.png"
  }
});

支持的模型

服务器支持以下即梦AI模型：

  • 图片模型
  • jimeng-3.1：即梦第三代模型，丰富的美学多样性，画面更鲜明生动 （默认）
  • jimeng-3.0：即梦第三代模型，效果更好，支持更强的图像生成能力
  • jimeng-2.1：即梦2.1版本模型，默认模型
  • jimeng-2.0-pro：即梦2.0 Pro版本
  • jimeng-2.0：即梦2.0标准版本
  • jimeng-1.4：即梦1.4版本
  • jimeng-xl-pro：即梦XL Pro特殊版本
  • 视频模型
  • jimeng-video-3.0-pro：即梦视频3.0 Pro模型，适合高质量视频生成
  • jimeng-video-3.0：即梦视频3.0标准模型，主力视频生成模型（默认）
  • jimeng-video-2.0-pro：即梦视频2.0 Pro模型，兼容性好，适合多场景
  • jimeng-video-2.0：即梦视频2.0标准模型，适合基础视频生成

技术实现

  • 直接调用即梦官方API，无需第三方服务
  • 逆向工程API调用流程，实现完整的图像生成过程
  • 支持积分自动领取和使用
  • 基于面向对象设计，将API实现封装为类
  • 返回高质量图像URL列表
  • 支持图片上传，自动处理本地/网络图片，自动切换混合模型
  • 图片混合时自动上传图片到即梦云端，流程全自动

使用示例

通过MCP协议调用图像生成功能：

// 生成图像（文本生成）
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "一只可爱的猫咪在草地上",
    model: "jimeng-3.0",
    width: 1024,
    height: 1024,
    sample_strength: 0.7,
    negative_prompt: "模糊，扭曲，低质量"
  }
});

// 生成图像（图片混合/参考图生成）
client.callTool({
  name: "generateImage",
  arguments: {
    prompt: "未来城市",
    filePath: "https://example.com/your-image.png"
  }
});

响应格式

API将返回生成的图像URL数组，可以直接在各类客户端中显示：

[
  "https://example.com/generated-image-1.jpg",
  "https://example.com/generated-image-2.jpg",
  "https://example.com/generated-image-3.jpg",
  "https://example.com/generated-image-4.jpg"
]

资源

服务器还提供了以下信息资源：

  • greeting://{name} - 提供个性化问候
  • info://server - 提供服务器基本信息
  • jimeng-ai://info - 提供即梦AI图像生成服务的使用说明

Cursor或Claude使用提示

在Cursor或Claude中，你可以这样使用Jimeng图像生成服务：

  1. 配置MCP服务器（推荐使用npx自动安装方式，见上方配置示例）
  2. 获取API Token（在即梦官网登录后从cookies获取sessionid）
  3. 开始使用，例如：
    请生成一张写实风格的日落下的山脉图片
    生成8张不同角度的可爱橘猫图片
  4. Claude/Cursor会自动调用Jimeng MCP服务器生成图像并显示

优势：

  • npx方式无需手动安装，配置后即可使用
  • 支持继续生成功能，可以一次生成多张图片
  • 支持多种模型和参数调整

常见问题

  1. 图像生成失败

    • 检查JIMENG_API_TOKEN是否正确配置
    • 登录即梦官网检查账号积分是否充足
    • 尝试更换提示词，避免敏感内容
    • 若为图片混合，检查filePath路径/URL是否有效、图片是否可访问
    • 网络图片建议使用https直链，避免防盗链/权限问题

  2. 服务器无法启动

    • 确保已安装所有依赖
    • 确保环境变量正确设置
    • 检查Node.js版本是否为14.0或更高

许可证

MIT

即梦AI视频生成

本MCP服务器集成了即梦AI视频生成API，提供视频生成工具：

generateVideo - 提交视频生成请求并返回视频URL

  • 参数：
    • prompt：生成视频的文本描述（必填）
    • filePath：首帧和尾帧图片路径，支持数组，最多2个元素，分别为首帧和尾帧（可选）
    • model：模型名称，默认jimeng-video-3.0（可选）
    • resolution：分辨率，可选720p或1080p，默认720p（可选）
    • width：视频宽度，默认值：1024（可选）
    • height：视频高度，默认值：1024（可选）
    • refresh_token：即梦API令牌（可选，通常从环境变量读取）
    • req_key：自定义参数，兼容旧接口（可选）

注意：

  • filePath 支持本地绝对/相对路径和图片URL。
  • 若指定 filePath，可实现首帧/尾帧定制的视频生成。
  • 网络图片需保证可公开访问。

使用示例

通过MCP协议调用视频生成功能：

// 生成视频（文本生成）
client.callTool({
  name: "generateVideo",
  arguments: {
    prompt: "一只小狗在草地上奔跑，阳光明媚，高清",
    model: "jimeng-video-3.0",
    resolution: "720p",
    width: 1024,
    height: 1024
  }
});

// 生成视频（首帧/尾帧定制）
client.callTool({
  name: "generateVideo",
  arguments: {
    prompt: "城市夜景延时摄影",
    filePath: ["./first.png", "./last.png"],
    resolution: "1080p"
  }
});

视频响应格式

API将返回生成的视频URL字符串，可以直接在各类客户端中播放：

"https://example.com/generated-video.mp4"

支持api服务启动

如需以API服务方式启动（适合HTTP接口调用）：

cp .env.example .env   # 复制环境变量模板
# 根据需要编辑.env，填写JIMENG_API_TOKEN等配置

# 启动API服务
yarn start:api

API服务启动后将监听配置端口，支持通过HTTP接口调用即梦AI图像和视频生成功能。