desktop-image-manager-mcp

🚀 桌面图片管理 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 开发的桌面图片管理服务器，它提供了图片文件统计、查看和压缩等实用功能，能帮助用户高效管理桌面图片。

🚀 快速开始

环境要求

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

安装步骤

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

# 安装依赖
pnpm install

开发启动

# 启动开发服务器
pnpm dev

构建和运行

# 构建项目
pnpm build

# 运行服务器
pnpm start

调试方法

# 调试 MCP 服务
pnpm inspector

✨ 主要特性

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

📦 安装指南

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

# 安装依赖
pnpm install

💻 使用示例

基础用法

统计图片数量

• 功能：统计桌面上的图片文件总数。
• 操作步骤：
  1. 启动服务器。
  2. 使用 API 请求获取图片数量。

获取图片列表

• 功能：列出桌面上所有图片文件的名称。
• 操作步骤：
  1. 启动服务器。
  2. 使用 API 请求获取图片列表。

图片压缩

• 功能：支持压缩 JPG、PNG、WebP 等格式的图片文件，可自定义压缩质量。
• 操作步骤：
  1. 启动服务器。
  2. 上传需要压缩的图片文件。
  3. 设置压缩参数（如目标格式、压缩质量等）。
  4. 使用 API 请求进行压缩并下载结果。

高级用法

让 Trae 引用 ./demand.md 进行功能代码生成，简化版如下

... （这里是已经引入的领域知识）

打造一个 MCP 服务器，它能够：
- 功能：
  - 统计当前桌面上的图片文件数量
  - 获取对应文件的名称
  - 支持压缩图片

要求：
- 不需要给出 prompt 和资源相关代码。
- 你可以假设我的桌面路径为 /Users/{username}/Desktop

📚 详细文档

支持的图片格式

• JPG/JPEG
• PNG
• GIF
• BMP
• WebP
• TIFF
• SVG

🔧 技术细节

实现提示

让 Trae 引用 ./demand.md 进行功能代码生成，简化版如下

... （这里是已经引入的领域知识）

打造一个 MCP 服务器，它能够：
- 功能：
  - 统计当前桌面上的图片文件数量
  - 获取对应文件的名称
  - 支持压缩图片

要求：
- 不需要给出 prompt 和资源相关代码。
- 你可以假设我的桌面路径为 /Users/{username}/Desktop

📄 许可证

文档未提及许可证相关信息，故跳过该章节。

⚠️ 重要提示

• 请确保服务器运行环境满足最低要求：Node.js >= 16 和 pnpm >= 8。
• 在使用图片压缩功能时，建议测试不同参数组合以获得最佳效果。
• 保持代码仓库的整洁，定期清理不必要的依赖和文件。

🔍 操作示例

https://claude.ai/share/0ffbad1e-502e-4188-b008-0bb966acf06d