返回 MCP 目录
public公开dns本地运行

Image Download and Optimize

一个基于MCP协议的图像下载与优化服务

article

README

🚀 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 - 初始发布

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端