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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A Model Context Protocol server that manages desktop images, providing functionality to count, list, and compress image files stored on the desktop.

Related MCP Servers

@kazuph/mcp-fetch
kazuph
A
security
A
license
A
quality
Model Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
Last updated -
1
278
15
JavaScript
MIT License
File Operations MCP Server
bsmi021
A
security
A
license
A
quality
A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
Last updated -
12
6
TypeScript
MIT License
MCP Fetch
JeremyNixon
-
security
A
license
-
quality
Model Context Protocol server that enables Claude Desktop (or any MCP client) to fetch web content and process images appropriately.
Last updated -
11
MIT License
MCP Image Extractor
ifmelate
A
security
A
license
A
quality
A Model Context Protocol server that extracts images from URLs or base64 data and converts them into a format suitable for LLM analysis, allowing AI models to process and understand visual content.
Last updated -
3
53
4
MIT License

View all related MCP servers

Desktop Image Manager MCP Server