@mcpcn/mcp-image-compressor 1.0.4 → 1.0.6

package/README.md

@@ -1,287 +1,287 @@
-# Image Processor MCP Server
-
-这是一个用于图片处理的 MCP 服务器，提供了多种图片处理功能。
-
-## 功能特性
-
-1. 图片格式转换
-2. 图片压缩到指定大小
-3. 图片压缩到原始大小的指定百分比
-4. 图片尺寸缩放
-5. 读取图片元数据
-6. 图像旋转
-7. 图像翻转
-8. 添加文字水印
-
-## 安装
-
-```bash
-npm install
-```
-
-## 构建
-
-```bash
-npm run build
-```
-
-## 运行服务器
-
-```bash
-npm start
-```
-
-## 开发模式
-
-```bash
-npm run dev
-```
-
-## MCP 工具
-
-### 1. image_convert_format
-
-将图片转换为指定格式。
-
-**参数：**
-
-- `inputPaths`: 原图片路径数组，支持图片文件和目录
-- `targetFormat`: 要转换为的格式（jpg/png/webp/bmp等）
-- `outputPath`: 转换后的保存路径（可选，不指定则和原图片目录相同）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg", "path/to/images/"],
-  "targetFormat": "png",
-  "outputPath": "path/to/output/"
-}
-```
-
-### 2. image_compress_to_size
-
-将图片压缩到指定的文件大小。
-
-**参数：**
-
-- `inputPaths`: 原图片路径数组，支持图片文件和目录
-- `size`: 要压缩到的的目标大小（如1mb/500kb）
-- `overwrite`: 是否覆盖原图（可选，默认为false）
-- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "size": "500kb",
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-### 3. image_compress_to_percent
-
-将图片压缩到原始大小的指定百分比。
-
-**参数：**
-
-- `inputPaths`: 原图片路径数组，支持图片文件和目录
-- `percent`: 要压缩到原size的百分之多少（如50或50%）
-- `overwrite`: 是否覆盖原图（可选，默认为false）
-- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "percent": "50%",
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-### 4. image_resize
-
-调整图片尺寸。
-
-**参数：**
-
-- `inputPaths`: 原图片路径数组，支持图片文件和目录
-- `width`: 宽修改为多少（可选）
-- `height`: 高修改为多少（可选）
-- `overwrite`: 是否覆盖原图（可选，默认为false）
-- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "width": 800,
-  "height": 600,
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-### 5. image_metadata
-
-读取图片元数据。
-
-**参数：**
-
-- `inputPaths`: 待处理图片路径
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"]
-}
-```
-
-**返回示例：**
-
-```json
-{
-  "success": true,
-  "message": "成功读取了 1 个图片的元数据",
-  "metadata": {
-    "image.jpg": {
-      "format": "jpeg",
-      "width": 1920,
-      "height": 1080,
-      "space": "srgb",
-      "channels": 3,
-      "depth": "uchar",
-      "density": 72,
-      "isProgressive": false,
-      "hasProfile": true,
-      "hasAlpha": false
-    }
-  }
-}
-```
-
-### 6. image_rotate
-
-图像旋转。
-
-**参数：**
-
-- `inputPaths`: 待处理图片路径
-- `angle`: 旋转角度（顺时针为正值，逆时针为负值）
-- `overwrite`: 是否覆盖原图（可选，默认为false）
-- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "angle": 90,
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-### 7. image_flip
-
-图像翻转。
-
-**参数：**
-
-- `inputPaths`: 待处理图片路径
-- `flipType`: 翻转方式（"horizontal": 水平翻转, "vertical": 垂直翻转）
-- `overwrite`: 是否覆盖原图（可选，默认为false）
-- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "flipType": "horizontal",
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-### 8. image_watermark
-
-添加文字水印。
-
-**参数：**
-
-- `inputPaths`: 待处理图片路径
-- `text`: 水印内容（文字）
-- `position`: 水印添加方式（必填，可能的取值为：top-left（左上）、top-right（右上）、bottom-left（左下）、bottom-right（右下）、center（中央）、tile（铺满））
-- `density`: 满铺密度（可选参数，在水印添加方式为铺满时有效，取值范围为1-10的整数，1最稀疏，10最密）
-- `fontSize`: 文字尺寸（可选参数，单位为像素，不传则根据图片尺寸自动计算）
-- `overwrite`: 是否覆盖原图（可选，默认为false）
-- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
-
-**示例：**
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "text": "版权所有",
-  "position": "bottom-right",
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-铺满水印示例：
-
-```json
-{
-  "inputPaths": ["path/to/image.jpg"],
-  "text": "CONFIDENTIAL",
-  "position": "tile",
-  "density": 5,
-  "fontSize": 20,
-  "overwrite": false,
-  "outputPath": "path/to/output/"
-}
-```
-
-## 注意事项
-
-1. 所有功能都支持批量处理多个文件
-2. 支持处理整个目录中的图片（仅处理目录下的图片文件，不处理子目录中的）
-3. 支持的图片格式：jpeg、jpg、png、webp、gif、avif、tiff、bmp
-4. 压缩功能使用二分查找算法来找到最佳的压缩质量
-5. 当指定输出目录时，如果目录不存在会自动创建
-6. 所有错误都会被优雅地处理并记录，不会中断批处理过程
-
-## 使用作为 MCP 服务器
-
-该服务器实现了 Model Context Protocol (MCP) 规范，可以连接到支持 MCP 的客户端。
-
-### 配置环境变量
-
-在使用前，确保已安装所有依赖，并构建项目：
-
-```bash
-npm install
-npm run build
-```
-
-### 启动服务器
-
-```bash
-npm start
-```
-
-
-
-## 依赖
-
-- sharp: 用于图片处理
-- @modelcontextprotocol/sdk: MCP SDK
+# Image Processor MCP Server
+
+这是一个用于图片处理的 MCP 服务器，提供了多种图片处理功能。
+
+## 功能特性
+
+1. 图片格式转换
+2. 图片压缩到指定大小
+3. 图片压缩到原始大小的指定百分比
+4. 图片尺寸缩放
+5. 读取图片元数据
+6. 图像旋转
+7. 图像翻转
+8. 添加文字水印
+
+## 安装
+
+```bash
+npm install
+```
+
+## 构建
+
+```bash
+npm run build
+```
+
+## 运行服务器
+
+```bash
+npm start
+```
+
+## 开发模式
+
+```bash
+npm run dev
+```
+
+## MCP 工具
+
+### 1. image_convert_format
+
+将图片转换为指定格式。
+
+**参数：**
+
+- `inputPaths`: 原图片路径数组，支持图片文件和目录
+- `targetFormat`: 要转换为的格式（jpg/png/webp/bmp等）
+- `outputPath`: 转换后的保存路径（可选，不指定则和原图片目录相同）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg", "path/to/images/"],
+  "targetFormat": "png",
+  "outputPath": "path/to/output/"
+}
+```
+
+### 2. image_compress_to_size
+
+将图片压缩到指定的文件大小。
+
+**参数：**
+
+- `inputPaths`: 原图片路径数组，支持图片文件和目录
+- `size`: 要压缩到的的目标大小（如1mb/500kb）
+- `overwrite`: 是否覆盖原图（可选，默认为false）
+- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "size": "500kb",
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+### 3. image_compress_to_percent
+
+将图片压缩到原始大小的指定百分比。
+
+**参数：**
+
+- `inputPaths`: 原图片路径数组，支持图片文件和目录
+- `percent`: 要压缩到原size的百分之多少（如50或50%）
+- `overwrite`: 是否覆盖原图（可选，默认为false）
+- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "percent": "50%",
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+### 4. image_resize
+
+调整图片尺寸。
+
+**参数：**
+
+- `inputPaths`: 原图片路径数组，支持图片文件和目录
+- `width`: 宽修改为多少（可选）
+- `height`: 高修改为多少（可选）
+- `overwrite`: 是否覆盖原图（可选，默认为false）
+- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "width": 800,
+  "height": 600,
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+### 5. image_metadata
+
+读取图片元数据。
+
+**参数：**
+
+- `inputPaths`: 待处理图片路径
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"]
+}
+```
+
+**返回示例：**
+
+```json
+{
+  "success": true,
+  "message": "成功读取了 1 个图片的元数据",
+  "metadata": {
+    "image.jpg": {
+      "format": "jpeg",
+      "width": 1920,
+      "height": 1080,
+      "space": "srgb",
+      "channels": 3,
+      "depth": "uchar",
+      "density": 72,
+      "isProgressive": false,
+      "hasProfile": true,
+      "hasAlpha": false
+    }
+  }
+}
+```
+
+### 6. image_rotate
+
+图像旋转。
+
+**参数：**
+
+- `inputPaths`: 待处理图片路径
+- `angle`: 旋转角度（顺时针为正值，逆时针为负值）
+- `overwrite`: 是否覆盖原图（可选，默认为false）
+- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "angle": 90,
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+### 7. image_flip
+
+图像翻转。
+
+**参数：**
+
+- `inputPaths`: 待处理图片路径
+- `flipType`: 翻转方式（"horizontal": 水平翻转, "vertical": 垂直翻转）
+- `overwrite`: 是否覆盖原图（可选，默认为false）
+- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "flipType": "horizontal",
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+### 8. image_watermark
+
+添加文字水印。
+
+**参数：**
+
+- `inputPaths`: 待处理图片路径
+- `text`: 水印内容（文字）
+- `position`: 水印添加方式（必填，可能的取值为：top-left（左上）、top-right（右上）、bottom-left（左下）、bottom-right（右下）、center（中央）、tile（铺满））
+- `density`: 满铺密度（可选参数，在水印添加方式为铺满时有效，取值范围为1-10的整数，1最稀疏，10最密）
+- `fontSize`: 文字尺寸（可选参数，单位为像素，不传则根据图片尺寸自动计算）
+- `overwrite`: 是否覆盖原图（可选，默认为false）
+- `outputPath`: 存储路径（可选，不覆盖原图时如果没传则为原图所在目录）
+
+**示例：**
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "text": "版权所有",
+  "position": "bottom-right",
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+铺满水印示例：
+
+```json
+{
+  "inputPaths": ["path/to/image.jpg"],
+  "text": "CONFIDENTIAL",
+  "position": "tile",
+  "density": 5,
+  "fontSize": 20,
+  "overwrite": false,
+  "outputPath": "path/to/output/"
+}
+```
+
+## 注意事项
+
+1. 所有功能都支持批量处理多个文件
+2. 支持处理整个目录中的图片（仅处理目录下的图片文件，不处理子目录中的）
+3. 支持的图片格式：jpeg、jpg、png、webp、gif、avif、tiff、bmp
+4. 压缩功能使用二分查找算法来找到最佳的压缩质量
+5. 当指定输出目录时，如果目录不存在会自动创建
+6. 所有错误都会被优雅地处理并记录，不会中断批处理过程
+
+## 使用作为 MCP 服务器
+
+该服务器实现了 Model Context Protocol (MCP) 规范，可以连接到支持 MCP 的客户端。
+
+### 配置环境变量
+
+在使用前，确保已安装所有依赖，并构建项目：
+
+```bash
+npm install
+npm run build
+```
+
+### 启动服务器
+
+```bash
+npm start
+```
+
+
+
+## 依赖
+
+- sharp: 用于图片处理
+- @modelcontextprotocol/sdk: MCP SDK
 - TypeScript: 用于类型检查和编译 

package/dist/index.js

@@ -146,7 +146,9 @@ function generateOutputPath(inputPath, outputPath, suffix, format) {
     const newName = `${parsedPath.name}${suffix}${newExt}`;
     if (outputPath) {
         // 确保输出目录存在
-        fs.mkdirSync(outputPath, { recursive: true });
+        if (!fs.existsSync(outputPath)) {
+            fs.mkdirSync(outputPath, { recursive: true });
+        }
         return path.join(outputPath, newName);
     }
     return path.join(parsedPath.dir, newName);

package/package.json

@@ -1,42 +1,42 @@
-{
-  "name": "@mcpcn/mcp-image-compressor",
-  "version": "1.0.4",
-  "description": "MCP server for image compression",
-  "main": "dist/index.js",
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "ts-node index.ts",
-    "serve": "node dist/index.js"
-  },
-  "bin": {
-    "mcp-image-compressor": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "mcp",
-    "image",
-    "compressor",
-    "sharp",
-    "model-context-protocol"
-  ],
-  "author": "mcpcn",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "1.12.0",
-    "sharp": "^0.33.5",
-    "semver": "^7.6.3"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/sharp": "^0.31.1",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.0.0"
-  }
-}
+{
+  "name": "@mcpcn/mcp-image-compressor",
+  "version": "1.0.6",
+  "description": "MCP server for image compression",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node index.ts",
+    "serve": "node dist/index.js"
+  },
+  "bin": {
+    "mcp-image-compressor": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "image",
+    "compressor",
+    "sharp",
+    "model-context-protocol"
+  ],
+  "author": "mcpcn",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.12.0",
+    "sharp": "^0.33.5",
+    "semver": "^7.6.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/sharp": "^0.31.1",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.0"
+  }
+}