Skip to main content
Glama
Sign In
Desktop Image Manager MCP Server

Desktop Image Manager MCP Server

by zhixiaoqiang
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Desktop Image Manager MCP Server

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

操作示例：

示例图片 https://claude.ai/share/0ffbad1e-502e-4188-b008-0bb966acf06d

Related MCP server: MCP File Operations 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 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"
      ]
    }
}

注意事项

  1. 确保有足够的桌面访问权限

  2. 大文件压缩可能需要较长时间

  3. 压缩后的文件默认保存在桌面，文件名会添加 "-compressed" 后缀

技术栈

  • TypeScript

  • MCP SDK

  • Sharp (图片处理)

  • fs-extra (文件操作)

  • zod (参数验证)

许可证

MIT License

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

Available Tools

3 tools
compress-imageC

压缩图片

Inputs: fileName (required), outputName, quality.

count-desktop-imagesB

统计桌面上的图片文件数量

Inputs: no named parameters.

list-desktop-imagesB

获取桌面上的图片文件名称列表

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.1/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: compress-image modifies images, count-desktop-images provides quantitative data, and list-desktop-images provides qualitative data. An agent can easily distinguish between compression, counting, and listing operations.

    Naming Consistency4/5

    The tools follow a consistent verb_noun pattern (compress-image, count-desktop-images, list-desktop-images), but the use of hyphens instead of underscores is a minor deviation from the typical snake_case convention. The naming is still highly readable and predictable.

    Tool Count3/5

    With only 3 tools, the server feels thin for a 'Desktop Image Manager' domain, as it lacks operations like viewing, deleting, moving, or converting images. While the tools cover basic tasks, the count is borderline low for managing desktop images comprehensively.

    Completeness2/5

    There are significant gaps in the tool surface for image management: no tools for viewing images, deleting files, moving/organizing images, converting formats, or editing metadata. The server only covers compression, counting, and listing, which is insufficient for full lifecycle management of desktop images.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Filesystem MCP Server

      bsmi021
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
      6
      MIT

    • MCP File Operations Server

      Kavishankarks
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables Claude Desktop to perform file operations like reading, writing, listing directories, and managing files through natural language commands.
      MIT

    • Enhanced File Operations MCP

      SkippyzNJiff
      F
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive Model Context Protocol server that provides over 50 file and system management tools for AI models, including navigation, file operations, search, compression, and system information capabilities.
      -

    • Windows-MCP

      emilioejus
      A
      license
      B
      quality
      D
      maintenance
      An MCP server designed for managing files and folders specifically on the Windows Desktop. It enables users to perform file operations like deletion while implementing security measures to prevent path traversal outside the Desktop directory.
      1
      MIT