{"id":"0eb3986b-7cb3-46d5-ba8d-46cc02252f4d","slug":"hypervapor-mcp-image-processor","kind":"mcp","name":"mcp-image-processor","summary":"mcp server for image professing","owner":"HYPERVAPOR","repoUrl":"https://github.com/HYPERVAPOR/mcp-image-processor","license":"MIT","licenseTier":"permissive","trust":"community","stars":4,"match":null,"fewStars":true,"format":"mcp","createdAt":"2025-04-24T19:24:44.000Z","addedAt":"2026-10-14T05:54:06.364Z","logoUrl":"https://avatars.githubusercontent.com/u/129078862?u=1a22a2d0c50d3233671bb8894c9275e1999f6a6a&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["design-media","cloud-infra"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-15T01:37:28.606Z","sample":false,"url":"https://conduits.dev/tools/hypervapor-mcp-image-processor","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# MCP 图像处理服务器\n\n![NPM Version](https://img.shields.io/npm/v/%40modelcontextprotocol%2Fsdk)\n![MIT licensed](https://img.shields.io/npm/l/%40modelcontextprotocol%2Fsdk)\n\n[English README](README.en.md)\n\n基于 **Model Context Protocol (MCP)** 的高性能图像处理服务器，提供格式转换、尺寸调整、压缩优化等丰富的图像处理功能。\n\n---\n\n## 功能概览\n\n- 支持多种图像格式转换：JPEG、PNG、WebP、TIFF、GIF、AVIF、HEIF\n- 灵活的图像裁剪与尺寸调整\n- 图像质量压缩与元数据移除优化\n- 多种缩放模式，支持保持或调整宽高比\n- 旋转角度及水平/垂直翻转\n- 亮度、对比度、饱和度调整及模糊、锐化后处理\n\n---\n\n## 系统要求\n\n- Node.js 18 及以上版本\n- TypeScript 5 及以上版本\n- 支持 `sharp` 原生模块的运行环境\n\n---\n\n## 安装与快速开始\n\n### 1. 克隆仓库\n\n```bash\ngit clone https://github.com/HYPERVAPOR/mcp-image-processor.git\ncd mcp-image-processor\n```\n\n### 2. 安装依赖\n\n```bash\nnpm install\n```\n\n### 3. （可选）修改代码\n\n如果需要自定义 MCP Server 逻辑，请编辑 `src/index.ts`，修改完成后执行：\n\n```bash\nnpm run build\n```\n\n### 4. 配置 MCP Server\n\n以 `cline` 客户端为例，其他客户端（如 `cursor`, `cherryStudio`）配置类似：\n\n```json\n{\n  \"mcpServers\": {\n    \"image-processor\": {\n      \"autoApprove\": [],\n      \"disabled\": false,\n      \"timeout\": 60,\n      \"command\": \"C:\\\\Program Files\\\\nodejs\\\\node.exe\",\n      \"args\": [\"C:\\\\projs\\\\mcp-image-processor\\\\dist\\\\index.js\"],\n      \"transportType\": \"stdio\"\n    }\n  }\n}\n```\n\n> **注意**：请将 `command` 和 `args` 替换为你本地的真实路径。\n\n### 5. 启动使用\n\n确保 MCP Server 已启用：\n\n![启用 MCP Server](public/enabled-mcp.png)\n\n只需向 LLM 描述你想对图片执行的操作，并提供一个或多个图片的绝对路径，例如：\n\n```text\n请你将此图片转换为黑白色调，图片位于 \"C:\\projs\\MCP-image-server\\assets\\test\\climbing.png\"\n```\n\n效果演示：![demo](public/demo.gif)\n\n---\n\n## 可用工具接口说明\n\n### 1. `image.convertFormat` — 格式转换\n\n- **参数**：\n\n  - `imagesPath`: 绝对路径数组\n  - `outputFormat`: 目标格式（jpeg、png、webp、tiff、gif、avif、heif）\n  - `formatParams`（可选）:\n    - `quality`: 输出质量（0-100）\n    - `compressionLevel`: 压缩级别（0-9，9 为最高）\n\n- **功能**：将图片转换为指定格式，支持质量与压缩级别调整。\n\n---\n\n### 2. `image.cropResize` — 裁剪与尺寸调整\n\n- **参数**：\n\n  - `imagesPath`: 绝对路径数组\n  - `width`: 目标宽度（像素，可选）\n  - `height`: 目标高度（像素，可选）\n  - `resizeMode`: 调整模式（contain、cover、fill、inside、outside）\n  - `maintainRatio`: 是否保持宽高比（默认 `true`）\n  - `rotate`: 旋转角度（-360 到 360 度，可选）\n  - `flip`: 是否垂直翻转（可选）\n  - `mirror`: 是否水平翻转（可选）\n\n- **功能**：裁剪、缩放、旋转和翻转图片，支持多种尺寸调整策略。\n\n---\n\n### 3. `image.compressOptimize` — 压缩与优化\n\n- **参数**：\n\n  - `imagesPath`: 绝对路径数组\n  - `quality`: 输出质量（0-100，可选）\n  - `stripMetadata`: 是否移除 EXIF 等元数据（默认 `true`）\n  - `progressive`: 是否启用渐进式渲染（JPEG/PNG，可选）\n\n- **功能**：压缩图片，去除元数据，支持渐进式渲染。\n\n---\n\n### 4. `image.resize` — 图像缩放\n\n- **参数**：\n\n  - `imagesPath`: 绝对路径数组\n  - `width`: 目标宽度（像素，可选）\n  - `height`: 目标高度（像素，可选）\n  - `maintainRatio`: 是否保持宽高比（默认 `true`）\n  - `fitMode`: 缩放模式（contain、cover、fill、inside、outside，可选）\n\n- **功能**：缩放图片，支持保持比例或指定缩放模式。若开启保持比例且目标宽高比与原图不符，将返回错误。\n\n---\n\n### 5. `image.rotateFlip` — 旋转与翻转\n\n- **参数**：\n\n  - `imagesPath`: 绝对路径数组\n  - `rotateAngle`: 旋转角度（-360 到 360 度，可选）\n  - `flipHorizontal`: 是否水平翻转（镜像效果，可选）\n  - `flipVertical`: 是否垂直翻转（可选）\n\n- **功能**：旋转及水平/垂直翻转图片。\n\n---\n\n### 6. `image.postProcess` — 图像后处理\n\n- **参数**：\n\n  - `imagesPath`: 绝对路径数组\n  - `brightness`: 亮度调整（-1 到 1，可选）\n  - `contrast`: 对比度调整（-1 到 1，可选）\n  - `saturation`: 饱和度调整（-1 到 1，可选）\n  - `blur`: 模糊半径（像素，可选）\n  - `sharpen`: 锐化强度（0-100，可选）\n\n- **功能**：调整亮度、对比度、饱和度，支持模糊与锐化处理。\n\n---\n\n## 项目结构\n\n```\nMCP-image-server/\n├── src/                # TypeScript 源代码\n│   └── index.ts        # 主入口文件\n├── dist/               # 编译输出目录\n│   └── index.js        # 编译后的主入口文件\n├── test/               # 测试脚本目录\n├── package.json        # 项目配置及依赖\n└── tsconfig.json       # TypeScript 编译配置\n```\n\n---\n\n## 许可证\n\nMIT © 2025\n\n---\n\n感谢您使用 MCP 图像处理服务器，欢迎贡献与反馈！\n"}