Desktop Image Manager MCP Server

Desktop Image Manager MCP Server

site icon
2025.04.01 1
JavaScript图片管理文件压缩文件管理
Desktop Image Manager MCP Server 是一个基于 Model Context Protocol (MCP) 开发的桌面图片管理服务器,提供图片文件统计、查看和压缩功能。
View on GitHub

Overview

基本能力

产品定位

Desktop Image Manager MCP Server 是一个桌面图片管理工具,专注于图片文件的统计、查看和压缩。

核心功能

  • 统计桌面图片数量:快速获取桌面上的图片文件总数
  • 获取图片列表:列出桌面上所有图片文件的名称
  • 图片压缩:支持压缩 JPG、PNG、WebP 等格式的图片文件,可自定义压缩质量

适用场景

  • 需要快速统计桌面图片数量的场景
  • 需要批量查看桌面图片文件的场景
  • 需要压缩图片以节省存储空间的场景

工具列表

  1. 统计桌面图片数量
  2. 功能:统计桌面上的图片文件数量
  3. 使用方式:通过 pnpm buildpnpm start 启动服务后调用

  4. 获取图片列表

  5. 工具名称: list-desktop-images
  6. 功能:列出桌面上所有图片文件的名称
  7. 使用方式:通过 client.callTool 调用

  8. 压缩图片

  9. 工具名称: compress-image
  10. 功能:压缩指定图片文件
  11. 参数:
    • fileName: 要压缩的图片文件名
    • quality: 压缩质量 (1-100),默认 80
    • outputName: 输出文件名(可选)
  12. 使用方式:通过 client.callTool 调用

常见问题解答

  1. 权限问题:确保有足够的桌面访问权限
  2. 压缩时间:大文件压缩可能需要较长时间
  3. 输出位置:压缩后的文件默认保存在桌面,文件名会添加 "-compressed" 后缀

使用教程

使用依赖

  • Node.js >= 16
  • pnpm >= 8

安装教程

# 克隆项目
git clone <repository-url>
cd desktop-image-manager

# 安装依赖
pnpm install

调试方式

# 调试 MCP 服务
pnpm inspector

开发

# 启动开发服务器
pnpm dev

# 构建项目
pnpm build

# 运行服务器
pnpm start

许可证

该项目遵循 MIT 开源许可条款。