Image Download And Optimize

🚀 MCP 图像下载器

MCP 图像下载器是一个基于 Model Context Protocol (MCP) 的服务器，为用户提供了下载和优化图像的工具。借助 Node.js 构建，它允许 AI 助手从 URL 下载图像，并能执行基础的图像优化任务。

🚀 快速开始

MCP 图像下载器使用便捷，您只需按以下步骤操作，即可开启图像下载和优化之旅。

安装步骤

# 克隆仓库
git clone https://github.com/qpd-v/mcp-image-downloader.git
cd mcp-image-downloader

# 安装依赖
npm install

# 构建项目
npm run build

配置使用

将服务器添加到您的 MCP 配置中（例如在 Claude Desktop 的配置文件中）：

{
  "mcpServers": {
    "image-downloader": {
      "command": "node",
      "args": ["/path/to/mcp-image-downloader/build/index.js"]
    }
  }
}

✨ 主要特性

• 图像下载：可通过 URL 从互联网下载图像，并能正确处理错误。
• 图像优化：提供了丰富的优化选项，包括：
  • 调整大小：在保持纵横比的前提下，对图像大小进行调整。
  • 质量调整：针对 JPEG 和 WebP 格式的图像，可灵活调整其质量。
  • 格式转换：支持多种图像格式之间的转换。

📦 安装指南

# 克隆仓库
git clone https://github.com/qpd-v/mcp-image-downloader.git
cd mcp-image-downloader

# 安装依赖
npm install

# 构建项目
npm run build

💻 使用示例

可用工具

download_image

从 URL 下载图像并保存到指定路径。

{
  "name": "download_image",
  "parameters": {
    "url": "https://example.com/image.jpg",
    "outputPath": "/path/to/save/image.jpg"
  }
}

参数说明：

• url: 需要下载的图像 URL。
• outputPath: 保存图像的目标路径。

optimize_image

根据指定参数生成优化版本的图像。

{
  "name": "optimize_image",
  "parameters": {
    "inputPath": "/path/to/input/image.jpg",
    "outputPath": "/path/to/output/image.jpg",
    "width": 800,
    "quality": 80
  }
}

参数说明：

• inputPath: 输入图像的路径。
• outputPath: 优化后图像的保存路径。
• width（可选）: 目标宽度（保持纵横比，如果仅指定宽度）。
• height（可选）: 目标高度（保持纵横比，如果仅指定高度）。
• quality（可选）: JPEG/WebP 质量（1 - 100）。

🔧 技术细节

开发运行

# 以开发模式运行
npm run start

# 构建项目
npm run build

系统需求

• Node.js 16 或更高版本。
• NPM 或兼容的包管理器。

📄 许可证

本项目采用 MIT 许可证，详细信息请参阅 LICENSE 文件。

👨‍💻 作者

qpd-v

🔖 版本

0.1.0 - 初始发布