Imagician 图像编辑 MCP 服务器

使用说明内容（Markdown格式）

• 项目简介

  • Imagician 是一个用 Node/TypeScript 编写的 MCP 服务器实现，利用 MCP SDK 提供的工具框架来执行图像编辑相关的任务。它通过 JSON-RPC 的标准请求/响应格式，与 LLM 客户端通信，注册并执行多种图像处理工具。

• 主要功能点

  • MCP 服务器核心：实现通过标准的 JSON-RPC 请求与客户端交互，处理工具（Tools）的注册、查询与执行。
  • 工具集合（Tools）：提供诸如 resize_image、convert_format、crop_image、compress_image、rotate_image、flip_image、get_image_info、batch_resize 等多种图像处理工具及其输入/输出定义。
  • 任务执行与管线：支持单次工具调用以及批量操作，输出结果以文本提示形式返回，并将生成的文件保存到指定路径。
  • 安全与扩展性：具备插件化能力，允许通过插件扩展新的编辑器和变换，按需加载和配置。
  • 多传输支持（初步实现）：当前实现使用标准输入/输出（stdio）传输进行 JSON-RPC 通信，后续可扩展到 SSE、WebSocket 等传输方式。
  • 运行环境与工作目录：通过 workspace 目录管理源图像、输出等资源，确保可重复的工作流和管线配置。

• 安装步骤

  • 安装 Node.js 和 npm（确保环境支持 TypeScript 运行及本地依赖安装）。
  • 获取代码：克隆或下载仓库。
  • 安装依赖：在项目目录执行依赖安装。
  • 构建/启动：
    • 开发/调试时，可直接运行源码（使用 TypeScript 运行环境）或构建后运行 dist 目录中的产物。
    • 生产或打包时，通常以 dist/index.js 作为入口执行 node dist/index.js。
  • 运行后验证：确保服务器以 “Imagician MCP server running” 等日志输出表示启动成功。

• 服务器配置（MCP 客户端需要的启动配置，JSON 形式，包含 server name、command、args 等）

  • 服务器名称（server_name）: imagician
  • 启动命令（command）: ["node", "dist/index.js"]
  • 启动参数（args）: [] 注释说明：该配置用于指导 MCP 客户端如何启动并连接 Imagician 服务器。命令会在客户端进程中以子进程方式运行，Imagician 将通过标准输入/输出（stdio）与客户端建立 JSON-RPC 通信通道。客户端本身不需要包含图片处理逻辑，只需要能向服务器发送合规的 MCP 请求并接收响应。

• 基本使用方法

  • 客户端与服务器建立连接后，首先可以通过工具列表请求（ListTools）查看服务器支持的工具及输入输出格式。
  • 通过工具调用（CallTool）执行具体的图像处理任务，例如对输入图片进行缩放、格式转换、裁剪等，并指定输出路径。
  • 你还可以对单张图片进行多种尺寸的批量处理，输出到指定目录。
  • 监控与结果：工具调用返回的文本内容将提示处理结果，输出的文件将出现在指定的输出路径中，可直接用于后续的内容分发。