MCP Image Downloader 使用说明

项目简介

MCP Image Downloader 是一个基于 Model Context Protocol (MCP) 构建的服务器应用，旨在为AI助手提供图片下载和优化的能力。通过集成此服务器，AI助手可以扩展其功能，实现从URL下载图片并进行基本的优化处理，例如调整尺寸、质量和格式转换。

主要功能点

图片下载: 从指定的URL地址下载图片。
图片优化: 对本地图片进行优化处理，包括：
- 调整尺寸: 可以指定宽度或高度，保持图片宽高比进行缩放。
- 质量调整: 调整JPEG或WebP格式图片的质量，以平衡文件大小和视觉效果。
- 格式转换: 支持图片格式转换 (虽然代码中没有显式格式转换选项，但 'sharp' 库本身支持，可以理解为优化过程中可能涉及格式的隐式处理)。

安装步骤

克隆仓库 打开终端，执行以下命令克隆代码仓库到本地：

git clone https://github.com/qpd-v/mcp-image-downloader.git
cd mcp-image-downloader

安装依赖 在项目根目录下，运行npm命令安装项目依赖：
```
npm install
```
构建项目 执行以下命令构建项目，生成可执行的JavaScript文件：
```
npm run build
```
构建完成后，会在项目根目录下生成 'build' 文件夹，服务器程序 'index.js' 位于 'build' 文件夹内。

服务器配置

要将 MCP Image Downloader 服务器添加到您的 MCP 客户端（例如 Claude Desktop），您需要在客户端的 MCP 服务器配置中添加以下JSON配置。请根据您的实际情况修改 'args' 中的路径。

{
  "mcpServers": {
    "image-downloader": {
      "command": "node",
      "args": ["/path/to/mcp-image-downloader/build/index.js"]
      // 请将 "/path/to/mcp-image-downloader" 替换为 MCP Image Downloader 项目在您本地文件系统中的实际路径。
      // 例如，如果您的项目放在用户Home目录下的 "my-mcp-servers" 文件夹中，则应修改为：
      // "args": ["/Users/yourusername/my-mcp-servers/mcp-image-downloader/build/index.js"]
      // 或
      // "args": ["C:\\Users\\YourUsername\\my-mcp-servers\\mcp-image-downloader\\build\\index.js"] (Windows 系统)
    }
  }
}

配置说明:

'"image-downloader"': 是您为该MCP服务器定义的名称，可以自定义。
'"command": "node"': 指定运行服务器的命令为 'node'，确保您的运行环境中已安装 Node.js。
'"args": [...]': 'args' 是一个字符串数组，包含了运行服务器程序所需的参数。
- 数组中的第一个元素是服务器程序 'index.js' 的路径。 请务必根据您的实际项目路径修改此项。

基本使用方法

配置完成后，您的 MCP 客户端应该能够检测到名为 'image-downloader' 的 MCP 服务器。AI助手可以通过调用服务器提供的工具来使用图片下载和优化功能。

可用工具 (Tools):

'download_image': 下载图片

描述: 从URL下载图片到指定路径。
参数:
- 'url' (字符串, 必填): 要下载的图片URL地址。
- 'outputPath' (字符串, 必填): 图片保存的本地路径（包含文件名）。

示例请求 (MCP客户端发起):

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "name": "download_image",
    "arguments": {
      "url": "https://www.example.com/image.jpg",
      "outputPath": "/path/to/save/image.jpg"
      // 请将 "/path/to/save/image.jpg" 替换为您希望保存图片的实际路径。
    }
  },
  "id": 1
}

'optimize_image': 优化图片

描述: 优化本地图片，可以调整尺寸和质量。
参数:
- 'inputPath' (字符串, 必填): 要优化的本地图片路径。
- 'outputPath' (字符串, 必填): 优化后图片保存的本地路径（包含文件名）。
- 'width' (数字, 可选): 目标宽度（像素）。如果只指定宽度，高度会按原图比例自动调整。
- 'height' (数字, 可选): 目标高度（像素）。如果只指定高度，宽度会按原图比例自动调整。
- 'quality' (数字, 可选): 图片质量，范围 1-100 (JPEG/WebP)。数值越高，质量越好，文件越大。