The Desktop Image Manager MCP Server allows you to manage desktop images with these capabilities:
Count the total number of image files on the desktop
List all image file names on the desktop
Compress image files (JPG, PNG, WebP, etc.) with customizable quality settings
Integrates with macOS desktop to access and manage image files, with instructions for configuration on macOS systems
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Desktop Image Manager MCP Servercompress my vacation photos with 85% quality"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Desktop Image Manager MCP Server
基于 Model Context Protocol (MCP) 开发的桌面图片管理服务器,提供图片文件统计、查看和压缩功能。
操作示例:
https://claude.ai/share/0ffbad1e-502e-4188-b008-0bb966acf06d
Related MCP server: Filesystem MCP Server
功能特性
统计桌面图片数量:快速获取桌面上的图片文件总数
获取图片列表:列出桌面上所有图片文件的名称
图片压缩:支持压缩 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 inspectorMCP 工具使用说明
1. 统计桌面图片数量
# 构建项目
pnpm build
# 运行服务器
pnpm start2. 获取图片列表
// 工具名称: 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 文件包含了项目的主要信息、安装说明、使用方法和注意事项。如果您需要添加或修改任何内容,请告诉我。