项目简介
MCP图片生成服务是一个实现了 Model Context Protocol (MCP) 的后端服务。它允许兼容 MCP 协议的 AI 助手(如 LLM 客户端)调用图像生成功能。该服务利用 OpenAI API 将文本描述转换为图像文件。
主要功能点
- AI绘图工具: 提供一个名为 'generate_image_from_description' 的工具,接受文本描述作为输入。
- 调用OpenAI API: 内部调用 OpenAI 的图像生成模型(如 gpt-image-1)根据描述创建图片。
- 保存图片: 将生成的图片保存到本地文件系统指定目录。
- 返回文件路径: 将保存的图片文件路径返回给调用该工具的 AI 助手,以便其进一步处理或展示。
安装步骤
要运行此 MCP 服务器,您需要:
- Node.js: 确保您的系统安装了 Node.js (版本 v18 或更高)。
- OpenAI API Key: 从 OpenAI 平台 获取一个 API Key。
安装服务:
- 克隆仓库:
git clone https://github.com/kdr/mcp-draw.git cd mcp-draw - 安装依赖并构建项目:
这将生成可执行的服务器文件。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' 的工具,并提供一个包含图片描述的参数。
服务器接收到请求后,会执行以下操作:
- 验证并提取图片描述。
- 调用 OpenAI API 生成图片。
- 将生成的图片数据保存到 '--output-dir' 参数指定的目录下。
- 将保存成功的图片的 绝对文件路径 作为工具的返回结果发送回 MCP 客户端。
AI 助手收到文件路径后,可以根据其能力选择展示图片、进一步处理或告知用户图片已保存的位置。
信息
分类
AI与计算