AI导哈

图像处理工具包

一个基于FastMCP框架的图像处理工具包，提供多种电商和社交媒体海报生成功能。

  • by pidanmeng
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 pidanmeng/mcp-e-commerce-master

使用说明

e-commerce-master

这是一个基于 FastMCP 框架构建的 MCP (Model Context Protocol) 工具包。

功能

影楼后期大师实现了多个实用的图像处理工具：

  • 查询生图任务状态: 查询生图任务状态，并以自然语言形式输出结果
  • 产品图精修: 产品图精修工具，改为白色背景
  • 产品场景渲染图: 产品场景渲染图，通过产品图生成带场景的渲染图
  • 3D电商KV海报: 生成 3D 电商 KV 海报
  • 电商产品海报: 质感商业级电商产品场景海报
  • 小红书风格海报: 生成小红书风格的海报
  • 宠物风格海报: 生成卡通风格宠物海报（默认 16:9）

部署 MCP

{
  "mcpServers": {
    "e-commerce-master": {
      "args": ["-y","@pidanmoe/e-commerce-master"],
      "command": "npx",
      "env": {
        "LIB_SECRET_KEY": "",
        "LIB_ACCESS_KEY": ""
      }
    }
  }
}

使用说明

该项目遵循 Model Context Protocol 规范，可以通过标准 I/O 或其他传输方式与支持 MCP 的客户端进行通信。

工具介绍

产品图精修

产品图精修工具，对商品图片进行专业精修处理

  • 必填参数:
    • productImageUrl: 商品图的 URL 地址
  • 返回: 生图任务结果

产品场景渲染图

通过产品图生成带场景的渲染图工具，基于产品图片生成具有特定场景的高质量渲染图

  • 必填参数:
    • productImageUrl: 产品图的 URL 地址
    • prompt: 场景描述提示词
  • 可选参数:
    • size: 生成图片尺寸，可选 1k、2k、4k
    • width: 图片宽度
    • height: 图片高度
  • 返回: 生图任务结果

查询生图任务状态

查询生图任务状态，并以自然语言形式输出结果

  • 必填参数:
    • generateUuid: 生图任务 UUID，发起生图任务时返回的字段
  • 返回: 任务状态的自然语言描述

3D 电商 KV 海报

生成 3D 电商 KV 海报

  • 可选参数:
    • prompt: 提示词，建议：FY style + 自然语言描述内容
  • 默认参数:
    • 使用赛博朋克风格的电商促销场景提示词
  • 返回: 生图任务结果

电商产品海报

质感商业级电商产品场景海报

  • 可选参数:
    • prompt: 提示词，建议：Product Scene Poster + 自然语言描述内容
  • 默认参数:
    • 使用商业级奢侈品香水摄影提示词
  • 返回: 生图任务结果

小红书风格海报

生成小红书风格的海报

  • 可选参数:
    • prompt: 提示词，建议：FY style + 自然语言描述内容
  • 默认参数:
    • 使用升学季海报提示词
  • 返回: 生图任务结果

宠物风格海报

生成卡通风格宠物海报（默认 16:9）

  • 可选参数:
    • prompt: 提示词
  • 默认参数:
    • 使用可爱宠物主题提示词
  • 返回: 生图任务结果

安装依赖

bun install

运行项目

bun run dev

调试项目

bun run inspect

构建项目

bun run build

项目结构

  • [index.ts](file:///Volumes/SSD/_work/e-commerce-master/src/index.ts): 主入口文件，初始化并启动 FastMCP 服务器
  • [tools/](file:///Volumes/SSD/_work/e-commerce-master/src/tools/): 工具目录，包含各种图像处理工具
    • [check-image-generation-status.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/check-image-generation-status.ts): 实现了生图任务状态查询工具
    • [product-image-retouching.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/product-image-retouching.ts): 实现了产品图精修工具
    • [scene-rendering-from-product-image.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/scene-rendering-from-product-image.ts): 实现了产品场景渲染工具
    • [kvPoster.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/kvPoster.ts): 实现了 3D 电商 KV 海报工具
    • [productPoster.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/productPoster.ts): 实现了电商产品海报工具
    • [xiaohongshuPoster.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/xiaohongshuPoster.ts): 实现了小红书风格海报工具
    • [petPoster.ts](file:///Volumes/SSD/_work/e-commerce-master/src/tools/petPoster.ts): 实现了宠物风格海报工具
  • [utils/](file:///Volumes/SSD/_work/e-commerce-master/src/utils/): 工具类目录
    • [logger.ts](file:///Volumes/SSD/_work/e-commerce-master/src/utils/logger.ts): 日志工具模块
    • [comfyui.ts](file:///Volumes/SSD/_work/e-commerce-master/src/utils/comfyui.ts): ComfyUI 接口调用模块

技术栈

  • Bun - JavaScript/TypeScript 运行时
  • FastMCP - MCP 框架
  • Zod - TypeScript-first schema declaration and validation library

此项目使用 bun v1.2.19 创建。Bun 是一个快速的一体化 JavaScript 运行时。

相关 MCP