关键词

图像处理Minecraft纹理编辑图片工具资源包生成实时图像

项目简介

Imagician是一个高性能的MCP服务器，专门用于Minecraft生态系统中的图像编辑和处理。它提供了一个稳定、快速的运行环境，能够实时编辑纹理、资源包和各种图片。Imagician通过模块化设计和插件系统，确保了编辑工作流的清晰和可扩展性，帮助开发者和运营者在游戏、地图制作或资源包准备过程中获得可预测的图像编辑结果。

主要功能点

  • 实时图像编辑： 提供低延迟的图像处理能力，支持多种编辑操作。
  • 丰富的图像工具： 内置了包括图片尺寸调整、格式转换、裁剪、压缩、旋转、翻转、获取图片信息以及批量尺寸生成等功能。
  • 可扩展的插件系统： 允许轻松集成自定义编辑器、滤镜和特效，以满足特定需求。
  • 批处理能力： 支持对图像包和纹理进行批处理，提高效率。
  • 简洁配置： 提供清晰的配置选项，方便设置端口、路径、日志和插件行为。
  • 健康检查： 内置健康检查和状态报告功能，便于监控服务器运行状况。

安装步骤

Imagician提供预构建的二进制文件，您可以直接下载并运行。

  1. 访问发布页面： 前往GitHub仓库的 Releases 页面。
  2. 下载适合您平台的二进制文件： 例如，对于Linux 64位系统，下载 'imagician-linux-x86_64.tar.gz'。对于Windows或macOS，请选择相应的版本。
  3. 解压文件： 将下载的压缩包解压到您选择的目录。
  4. 运行服务器： 打开终端或命令提示符，进入解压后的目录，然后运行服务器二进制文件，例如：
    • Linux/macOS: './imagician-server --config /path/to/your/config.json'
    • Windows: 'imagician-server.exe --config C:\path\to\your\config.json'
    • （'/path/to/your/config.json' 是您存放配置文件的路径，详情见“服务器配置”部分。）
  5. 验证服务： 服务器启动后，您可以通过查看日志或访问健康检查接口（如果已配置）来确认其正常运行，例如：'curl http://localhost:25566/health'。

服务器配置

MCP客户端需要通过启动命令连接MCP服务器。以下是配置Imagician MCP服务器的启动信息，以便MCP客户端与其建立连接：

{
  "serverName": "imagician",
  "command": "imagician-server",
  "args": [
    "--config",
    "/path/to/your/config.json"
  ],
  "description": "Imagician是一个用于Minecraft图像编辑的MCP服务器。请将/path/to/your/config.json替换为您的Imagician服务器配置文件的实际路径。您还需要确保imagician-server二进制文件位于系统PATH中或提供其完整路径。",
  "env": {
    "IMAGICIAN_PORT": "25566",
    "IMAGICIAN_BIND": "0.0.0.0",
    "IMAGICIAN_WORKSPACE_DIR": "/opt/imagician/workspace"
  }
}

配置说明：

  • 'serverName': 服务器的名称，这里是'imagician'。
  • 'command': 启动Imagician服务器的命令。如果您将二进制文件放在系统PATH中，可以直接使用'imagician-server'。否则，请提供其完整路径，例如'/usr/local/bin/imagician-server'。
  • 'args': 启动命令的参数列表。'--config' 参数后接的是Imagician服务器自身使用的配置文件路径。请务必将'/path/to/your/config.json'替换为Imagician实际的配置文件路径，该文件用于定义端口、工作目录和编辑管道等。
  • 'description': 对此MCP服务器的简要说明和配置提示。
  • 'env': 可以在这里设置环境变量，例如覆盖配置文件中的端口、绑定地址和工作目录等。

基本使用方法

Imagician服务器启动后，MCP客户端可以通过调用其注册的工具来进行图像处理。例如，以下是一个通过MCP客户端调用 'resize_image' 工具的示例流程（具体的客户端调用方式取决于您使用的MCP客户端）：

  1. 准备图像： 将您要处理的源图像放置在Imagician服务器配置的工作目录（'workspace_dir'）中，例如 'assets/source/my_image.png'。
  2. 调用工具： MCP客户端向Imagician服务器发送一个 'tools/call' 请求，指定要调用的工具（例如 'resize_image'）及其参数。
    • 示例工具调用（概念性，非MCP客户端实际JSON-RPC请求）： 
      # 调用 resize_image 工具，将图片缩放到800x600像素
tool_name: "resize_image"
arguments:
  inputPath: "assets/source/my_image.png"
  outputPath: "assets/output/my_image_resized.png"
  width: 800
  height: 600
  fit: "cover"
  3. 获取结果： Imagician服务器处理请求后，会将处理后的图像保存到 'outputPath' 指定的位置，并返回一个包含处理结果的消息。MCP客户端会接收到这个响应。
  4. 访问处理后的图像： 您可以通过Imagician服务器的交付机制（例如，如果配置了HTTP API，可以通过 'GET /assets/{path}' 访问）或直接从服务器的文件系统获取处理后的图像。

核心图像处理工具列表：

  • 'resize_image': 调整图像尺寸。
  • 'convert_format': 转换图像格式（JPEG, PNG, WebP, AVIF）。
  • 'crop_image': 裁剪图像的特定区域。
  • 'compress_image': 压缩图像以减小文件大小。
  • 'rotate_image': 旋转图像。
  • 'flip_image': 水平或垂直翻转图像。
  • 'get_image_info': 获取图像的元数据信息。
  • 'batch_resize': 对一张图片生成多种尺寸的变体。

信息

分类

开发者工具

访问项目