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 - 初始发布
微信扫一扫