测试图像生成器

一个可生成自定义尺寸和颜色的测试图像的服务,支持PNG格式保存和自动文本叠加。

  • by sam2332
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 sam2332/Mcp-Server-Placeholder-Image-Generator

使用说明

图像生成器MCP服务器

一种模型上下文协议(MCP)服务器,可生成具有可自定义宽度、高度和颜色的测试图像。将图像另存为PNG文件到指定的文件路径。

特性

  • 生成具有指定尺寸(1-4096像素)的测试图像
  • 支持十六进制颜色格式(例如#FF0000、#f00)
  • 显示图像尺寸的自动文本叠加
  • 左上角显示的可选自定义标签文本
  • 智能对比色选择,便于阅读文本
  • 将图像另存为PNG文件到指定的文件路径
  • 如果目录不存在,则自动创建目录

安装

  1. 克隆或下载此存储库
  2. 安装依赖项:
npm install
  1. 构建服务器:
npm run build
  1. 将服务器添加到MCP配置中:

对于VSCode:

{
    "servers": {
        "Image Placeholder Gen": {
            "type": "stdio",
            "command": "node",
            "args": [
                "~/mcp_servers/image-gen/build/index.js"
            ]
        }
    }
}

对于Claude Desktop:

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": ["/path/to/image-gen/build/index.js"]
    }
  }
}

用法

服务器提供了一个工具:

generate_test_image

生成具有指定参数的测试图像。

参数:

  • width (number):图像的宽度(像素)(1-4096)
  • height (number):图像的高度(像素)(1-4096)
  • color (string):以十六进制代码表示的图像颜色(例如#FF0000或#f00)
  • filepath (string):保存PNG图像的完整路径
  • label (字符串,可选):自定义文本显示在图像的左上角

例子:

{
  "name": "generate_test_image",
  "arguments": {
    "width": 400,
    "height": 300,
    "color": "#3498db",
    "filepath": "/tmp/test_image.png",
    "label": "My Custom Label"
  }
}

退货:

  • 文本确认图像已成功生成并保存

颜色格式

该工具支持十六进制颜色格式:

  • 十六进制颜色: #FF0000, #f00

测试

运行测试脚本以验证服务器是否正常工作:

npm run build
npm test

依赖项

  • 用于图像生成的Node.js画布库
  • 模型上下文协议SDK

备注

  • 为了提高性能,最大图像尺寸限制为4096x4096像素
  • 生成的图像包括尺寸文本叠加,便于识别
  • 文本颜色会自动选择,以获得与背景的最佳对比度
  • 如果指定的文件路径中不存在目录,服务器会自动创建目录

贡献

请随时提交问题和增强请求!