项目简介

MCP图片生成服务是一个实现了 Model Context Protocol (MCP) 的后端服务。它允许兼容 MCP 协议的 AI 助手(如 LLM 客户端)调用图像生成功能。该服务利用 OpenAI API 将文本描述转换为图像文件。

主要功能点

  • AI绘图工具: 提供一个名为 'generate_image_from_description' 的工具,接受文本描述作为输入。
  • 调用OpenAI API: 内部调用 OpenAI 的图像生成模型(如 gpt-image-1)根据描述创建图片。
  • 保存图片: 将生成的图片保存到本地文件系统指定目录。
  • 返回文件路径: 将保存的图片文件路径返回给调用该工具的 AI 助手,以便其进一步处理或展示。

安装步骤

要运行此 MCP 服务器,您需要:

  1. Node.js: 确保您的系统安装了 Node.js (版本 v18 或更高)。
  2. OpenAI API Key:OpenAI 平台 获取一个 API Key。

安装服务:

  1. 克隆仓库:
    git clone https://github.com/kdr/mcp-draw.git
    cd mcp-draw
  2. 安装依赖并构建项目:
    npm install
    npm run build
    这将生成可执行的服务器文件。

MCP客户端配置

您的 MCP 客户端需要知道如何启动并连接到这个服务器。以下是一个常见的 MCP 客户端配置文件片段示例(请根据您的客户端实际情况调整):

{
  "mcpServers": {
    "mcp-draw": {
      "command": "node", // 或 "npx" 如果使用npx方式启动
      "args": [
        "/ABSOLUTE/PATH/TO/mcp-draw/build/index.js", // 替换为服务器构建后index.js文件的绝对路径
        // 或使用npx方式:"-y", "mcp-draw@latest",
        "--api-key",
        "<REPLACE-WITH-YOUR-OPENAI-API-KEY>", // 替换为您的OpenAI API Key
        "--output-dir",
        "/ABSOLUTE/PATH/TO/SAVE/OUTPUT_FOLDER" // 替换为希望保存生成图片的本地目录的绝对路径
      ]
    }
  }
}

配置说明:

  • '"mcp-draw"': 您为这个服务器定义的名称,供客户端内部识别。
  • '"command"': 启动服务器进程的命令(例如 'node' 或 'npx')。
  • '"args"': 传递给启动命令的参数列表。
    • 第一个参数通常是服务器脚本的路径 ('node' 方式) 或包名 ('npx' 方式)。
    • '--api-key <您的API Key>': 必需,用于认证 OpenAI API。
    • '--output-dir <输出目录绝对路径>': 必需,指定生成图片保存的本地目录绝对路径。请确保该目录存在或服务器有权限创建。

基本使用方法

配置完成后,您的 MCP 客户端在需要生成图片时,会通过 MCP 协议与该服务器通信。客户端(或其背后的 LLM)会发现并调用名为 'generate_image_from_description' 的工具,并提供一个包含图片描述的参数。

服务器接收到请求后,会执行以下操作:

  1. 验证并提取图片描述。
  2. 调用 OpenAI API 生成图片。
  3. 将生成的图片数据保存到 '--output-dir' 参数指定的目录下。
  4. 将保存成功的图片的 绝对文件路径 作为工具的返回结果发送回 MCP 客户端。

AI 助手收到文件路径后,可以根据其能力选择展示图片、进一步处理或告知用户图片已保存的位置。

信息

分类

AI与计算