Desktop Image Manager MCP Server

基于 Model Context Protocol (MCP) 开发的桌面图片管理服务器，提供图片文件统计、查看和压缩功能。

操作示例：

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

功能特性

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

实现提示

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

... （这里是已经引入的 domain knowledge）

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

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

支持的图片格式

JPG/JPEG
PNG
GIF
BMP
WebP
TIFF
SVG

环境要求

Node.js >= 16
pnpm >= 8

安装

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

# 安装依赖
pnpm install

开发

# 启动开发服务器
pnpm dev

构建和运行

# 构建项目
pnpm build

# 运行服务器
pnpm start

调试

# 调试 MCP 服务
pnpm inspector

MCP 工具使用说明

1. 统计桌面图片数量

# 构建项目
pnpm build

# 运行服务器
pnpm start

2. 获取图片列表

// 工具名称: list-desktop-images
// 参数: 无
await client.callTool({
  name: "list-desktop-images"
});

3. 压缩图片

// 工具名称: compress-image
// 参数:
// - fileName: 要压缩的图片文件名
// - quality: 压缩质量 (1-100)，默认 80
// - outputName: 输出文件名（可选）
await client.callTool({
  name: "compress-image",
  arguments: {
    fileName: "example.jpg",
    quality: 75,
    outputName: "example-compressed.jpg"
  }
});

开发

# 启动开发服务器
pnpm dev

安装

使用 Claude Desktop 添加如下配置 config:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "desktop-image-manager": {
      "command": "npx",
      "args": [
        "-y",
        "@jzone-mcp/desktop-image-manager-mcp"
      ]
    }
}

注意事项

确保有足够的桌面访问权限
大文件压缩可能需要较长时间
压缩后的文件默认保存在桌面，文件名会添加 "-compressed" 后缀

技术栈

TypeScript
MCP SDK
Sharp (图片处理)
fs-extra (文件操作)
zod (参数验证)

许可证

MIT License

这个 README 文件包含了项目的主要信息、安装说明、使用方法和注意事项。如果您需要添加或修改任何内容，请告诉我。

Desktop Image Manager MCP Server

Integrations

Desktop Image Manager MCP Server

操作示例：

功能特性

实现提示

支持的图片格式

环境要求

安装

开发

构建和运行

调试

MCP 工具使用说明

1. 统计桌面图片数量

2. 获取图片列表

3. 压缩图片

开发

安装

注意事项

技术栈

许可证

Tools