Desktop Image Manager Mcp
What is Desktop Image Manager Mcp
The desktop-image-manager-mcp is an MCP server designed for managing desktop images. It allows users to view details, compress, and move image files efficiently.
Use cases
Use cases include quickly counting images on a desktop, generating a list of all image files for organization, and compressing images to save storage space or optimize for web use.
How to use
To use the desktop-image-manager-mcp, clone the repository, install dependencies using pnpm, and start the server. You can then utilize commands to count images, list them, or compress specific files.
Key features
Key features include counting the number of image files on the desktop, retrieving a list of image file names, and compressing images in formats such as JPG, PNG, and WebP with customizable quality settings.
Where to use
This MCP server is suitable for personal use on desktops, as well as in environments where image management is critical, such as graphic design, content creation, and digital asset management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Desktop Image Manager Mcp
The desktop-image-manager-mcp is an MCP server designed for managing desktop images. It allows users to view details, compress, and move image files efficiently.
Use cases
Use cases include quickly counting images on a desktop, generating a list of all image files for organization, and compressing images to save storage space or optimize for web use.
How to use
To use the desktop-image-manager-mcp, clone the repository, install dependencies using pnpm, and start the server. You can then utilize commands to count images, list them, or compress specific files.
Key features
Key features include counting the number of image files on the desktop, retrieving a list of image file names, and compressing images in formats such as JPG, PNG, and WebP with customizable quality settings.
Where to use
This MCP server is suitable for personal use on desktops, as well as in environments where image management is critical, such as graphic design, content creation, and digital asset management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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 文件包含了项目的主要信息、安装说明、使用方法和注意事项。如果您需要添加或修改任何内容，请告诉我。
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
