image-tools-mcp

🚀 图像工具 MCP 服务

Image Tools MCP（模型上下文协议）服务是一款强大的图像处理工具，可获取图片尺寸、压缩优化图片、转换图片格式，还能从 Figma 文件提取图片链接，为图像处理提供了一站式解决方案。

🚀 快速开始

该工具可以通过命令行或集成到其他系统中使用。不过为了使所有功能正常运行，建议设置以下环境变量：

• TINIFY_API_KEY：用于调用 TinyPNG 接口。获取方式请访问 TinyPNG 开发者页面
• FIGMA_API_TOKEN：用于与 Figma API 交互。获取方式请参考 Figma 开发文档

注意：基础功能（获取尺寸信息）无需上述环境变量即可使用。

✨ 主要特性

• 获取图片尺寸：支持通过 URL 获取远程图片的宽度和高度，也能读取本地图片文件的实际尺寸。
• 压缩优化：使用 TinyPNG 接口实现在线压缩，在保留原图质量的同时大幅减少文件大小。
• 格式转换：支持将图片在 WebP、JPEG、JPG 和 PNG 等常用格式间进行转换。
• Figma 集成：可解析 Figma 文件中的所有图片资源，并提供完整的图片链接列表。

💻 使用示例

基础用法

以下是主要接口规范的使用示例：

获取远程图片尺寸

{
  options: {
    imageUrl: string // 需要获取尺寸的图片 URL 地址
  }
}

获取本地图片尺寸

{
  options: {
    imagePath: string; // 绝对路径的本地图片文件
  }
}

压缩远程图片

{
  options: {
    imageUrl: string // 需要压缩的图片 URL 地址
    outputFormat?: "image/webp" | "image/jpeg" | "image/jpg" | "image/png" // 可选输出格式
  }
}

压缩本地图片

{
  options: {
    imagePath: string // 绝对路径的本地图片文件
    outputPath?: string // 可选的目标输出路径
    outputFormat?: "image/webp" | "image/jpeg" | "image/jpg" | "image/png" // 可选输出格式
  }
}

Figma 文件处理

{
  options: {
    figmaUrl: string; // 需要解析的 Figma 文件链接
  }
}

🔧 技术细节

本项目基于以下优秀开源库构建：

• probe-image-size：用于快速获取图片尺寸。
• tinify：提供 TinyPNG 接口支持。
• figma-api：实现对 Figma 文件的解析。

📄 许可证

本项目遵循 MIT 开源协议，欢迎自由使用和修改。