lucky666666-wq/mcp-image-converter

🌌 MCP图片转换工具

一个强大的图片转换MCP服务器，为Cursor编辑器提供图片处理功能。支持格式转换、尺寸调整、批量处理等功能。

✨ 主要功能

• 🖼️ 图片格式转换: PNG ↔ JPEG ↔ WebP
• 📐 尺寸调整: 任意宽度和高度，智能裁剪
• 📊 图片信息获取: 详细的元数据信息
• 📦 批量处理: 整个目录的批量转换
• ⚡ 高性能: 基于Sharp库，快速高质量处理
• 🎯 质量控制: 自定义JPEG/WebP质量

🚀 快速安装

方法一：一键安装（推荐）

# 下载项目
git clone <您的仓库地址>
cd mcp-image-converter

# 运行安装脚本
./install.sh

方法二：手动安装

# 1. 克隆仓库
git clone <您的仓库地址>
cd mcp-image-converter

# 2. 安装依赖
npm install

# 3. 测试功能
node test.js

⚙️ 配置Cursor

1. 打开Cursor设置

• 快捷键: ⌘+, (Mac) 或 Ctrl+, (Windows/Linux)

2. 添加MCP服务器

1. 点击左侧 "MCP"
2. 点击 "Add new global MCP server"
3. 填写以下信息：

Server Name: image-converter
Command: node
Arguments: /完整路径/mcp-image-converter/index.js
Working Directory: /完整路径/mcp-image-converter

3. 启用服务器

确保开关是绿色（启用状态）

🧪 使用示例

基础用法

请查看图片 /path/to/image.png 的详细信息

转换图片尺寸

请将图片 /path/to/image.png 转换为 800×600 像素的JPEG格式

批量处理

请批量转换目录 /path/to/images 中的所有图片为 1200×800 的PNG格式

高级选项

请将图片转换为200×200的JPEG格式，质量设置为80%

📊 支持的格式

输入格式

• JPEG (.jpg, .jpeg)
• PNG (.png)
• WebP (.webp)
• BMP (.bmp)
• TIFF (.tiff, .tif)
• GIF (.gif)

输出格式

• JPEG (.jpg) - 支持质量调节
• PNG (.png) - 无损压缩
• WebP (.webp) - 现代格式，支持质量调节

🛠️ 可用工具

1. convert_image

转换单个图片的尺寸和格式

参数:

• input_path: 输入图片路径 (必需)
• width: 目标宽度 (必需)
• height: 目标高度 (必需)
• output_path: 输出路径 (可选)
• format: 输出格式 (可选，默认 png)
• quality: 图片质量 1-100 (可选，默认 90)

2. get_image_info

获取图片的详细信息

参数:

• image_path: 图片文件路径 (必需)

3. batch_convert_images

批量转换整个目录中的图片

参数:

• input_directory: 输入目录路径 (必需)
• output_directory: 输出目录路径 (必需)
• width: 目标宽度 (必需)
• height: 目标高度 (必需)
• format: 输出格式 (可选)
• quality: 图片质量 (可选)

🔧 技术栈

• Node.js: 运行环境 (>=16.0.0)
• Sharp: 高性能图片处理库
• MCP SDK: Model Context Protocol 开发工具包

📋 系统要求

• Node.js: 16.0.0 或更高版本
• npm: 7.0.0 或更高版本
• 操作系统: macOS, Windows, Linux
• Cursor: 支持MCP的版本

🔄 故障排除

常见问题

1. MCP服务器不显示

• 检查Node.js版本是否 >= 16
• 确认路径是否正确（使用绝对路径）
• 重启Cursor编辑器

2. 图片处理失败

• 检查图片文件是否存在
• 确认有读写权限
• 检查磁盘空间是否充足

3. 依赖安装失败

# 清除缓存
npm cache clean --force

# 重新安装
rm -rf node_modules package-lock.json
npm install

运行测试

node test.js

手动测试功能

node -e "
const sharp = require('sharp');
sharp('input.jpg')
  .resize(200, 200)
  .jpeg({quality: 90})
  .toFile('output.jpg')
  .then(() => console.log('✅ 测试成功'))
  .catch(err => console.error('❌ 错误:', err));
"

📞 获取帮助

• 🐛 Bug报告: 请在GitHub Issues中提交
• 💡 功能建议: 欢迎提交Feature Request
• 📖 文档问题: 请查看Wiki或提交Issue
• 💬 使用问题: 可以在Discussions中讨论

📄 许可证

MIT License - 详见 文件

🙏 致谢

• Sharp - 强大的图片处理库
• Model Context Protocol - MCP协议规范
• Cursor - 智能代码编辑器

⭐ 如果这个工具对您有帮助，请给个Star支持一下！