【墨言开发文档】【即梦图像生成MCP服务】使用说明

309 阅读3分钟

摘要:【墨言】不止是个科学与工程计算软件,用它同样可以玩转MCP,本文介绍了在【墨言】中操作MCP的一个示例:【即梦图像生成】

一、服务来源

💡 github.com/fengin/imag…

二、功能总览

💡 该 MCP 服务器提供以下工具函数:

  1. 📚 文本生成图像

三、运行环境

💡 该 MCP 服务器依赖于以下运行环境:

  1. Python 3.10+
  2. Node.js 16.0.0+
  3. npm
  4. 安装python3后使用指令安装uv "pip install uv"

四、安装步骤

  1. 克隆仓库
git clone https://github.com/fengin/image-gen-server.git
cd image-gen-server

2. 安装依赖

pip install -r requirements.txt

3. 获取即梦sessionid,填充MCP

打开即梦官网 (jimeng.jianying.com/),然后登录账号,按 F12 打开“开发者工具”,

在 Application -> Cookies -> 中找到 sessionid,获取value值。

MCP 对应键值改造,在server.py中修改配置

# API配置
JIMENG_API_TOKEN = "替换为你的sessionid" # 你登录即梦获得的session_id,支持多个,在后面用逗号分隔   
IMG_SAVA_FOLDER = "D:/100.AITest/images" # 图片的默认保存路径

4. 在【墨言】MCP配置json文件中更改 server.py 文件的位置:

    "即梦图像生成MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "C:/Users/Administrator/image-gen-server/server.py"
      ]
    }

🔥 一键安装的方法

在【墨言】软件中运行以下代码,可以一键执行以上安装步骤:

// 第一步:克隆并安装依赖
执行操作系统命令批处理(【"git clone https://github.com/fengin/image-gen-server.git | cd image-gen-server | pip install -r requirements.txt | npm run build"】)

// 第二步:根据说明文档在server.py中修改配置
执行操作系统命令批处理(【"notepad.exe .\image-gen-server\server.py"】)

// 第三步:根据说明文档在json配置文件中修改MCP配置
MCP配置文件路径 = MCP配置Json文件地址()
打开MCP配置文件 = 连接字符串(【"notepad.exe "】, 【MCP配置文件路径】)
执行操作系统命令批处理(【打开MCP配置文件】)

五、MCP工具函数用法

在【墨言】软件中执行以下代码,就可以查询得到本MCP的所有工具函数:

获取预置MCP服务Json配置(【"即梦图像生成MCP"】) 保存到:【即梦图像生成Json字串】
创建MCP服务执行器(【即梦图像生成Json字串】) 保存到:【即梦图像生成服务执行器】

获取MCP服务的工具列表(【即梦图像生成服务执行器】)

执行结果显示,该MCP服务共有2个工具函数,实际上只有一个generate_image。

use_description():列出所有可用的工具及其参数
generate_image():根据文本描述生成图片
    
    Args:
        prompt: 图片的文本prompt描述,800字符长度限制,一个汉字算一个字符长度
        file_name: 生成图片的文件名,含后辍名(不含路径,如果没有后缀则默认使用.jpg)
        save_folder: 图片保存绝对地址目录(必选)
        sample_strength: 生成图片的精细度(可选,范围0-1,默认0.5)
        width: 生成图片的宽度(可选,默认1024,最大1024)
        height: 生成图片的高度(可选,默认1024,最大1024)
        
    Returns:
        List: 包含生成结果的JSON字符串

🔍 以下是这个工具函数的使用示例:

generate_image(prompt, file_name, save_folder, sample_strength, width, height)函数。

【墨言】执行语法示例:

提示词 = "你自己的提示词"
即梦参数 = 连接字符串(【"['prompt'|'", 提示词, "'];['file_name'|'图片文件名.jpg'];['save_folder'|'d:\桌面\test\images'];['width'|768];['height'|1024]"】)

获取预置MCP服务Json配置(【"即梦图像生成MCP"】) 保存到:【即梦图像生成Json字串】
创建MCP服务执行器(【即梦图像生成Json字串】) 保存到:【即梦图像生成服务执行器】
执行MCP服务的工具函数(【即梦图像生成服务执行器】,【"generate_image"】,【即梦参数】) 保存到:【即梦执行结果】

执行成功后,上述代码中指定的文件夹中就会出现即梦AI生成的图片了。