使用说明

项目简介

系统清理MCP服务器是一个实现了MCP协议的服务器,旨在为AI客户端提供系统垃圾文件清理功能。通过标准化的MCP接口,客户端可以调用服务器提供的工具,安全高效地清理临时文件、缓存文件、日志文件以及查找大文件,从而优化系统性能,释放宝贵的磁盘空间。

主要功能点

  • 系统状态查询: 获取操作系统类型、磁盘使用情况、内存信息、CPU使用率等系统状态。
  • 垃圾文件扫描: 扫描系统中的临时文件、缓存文件、日志文件等垃圾文件,并按类别进行统计。
  • 指定类别清理: 清理指定类别的垃圾文件,如临时文件、缓存文件或日志文件。
  • 自定义文件列表清理: 根据客户端提供的文件列表,精确清理指定的文件。
  • 回收站清空: 安全清空系统回收站,释放回收站占用的空间。
  • 大文件查找: 根据用户设定的最小大小,查找系统中的大文件,方便用户进行手动清理。
  • 配置更新: 允许客户端更新服务器的配置文件,例如扫描路径、文件清理规则等。
  • 试运行模式: 支持在不实际删除文件的情况下进行扫描和清理分析,方便用户预览清理效果。
  • 跨平台支持: 支持Windows、macOS和Linux三大操作系统。

安装步骤

  1. 环境准备: 确保您的计算机上已安装 Python 3.12 或更高版本。
  2. 下载代码: 从 GitHub 仓库 mcpchina/mcp-servers 下载代码,或者使用 'git clone https://github.com/mcpchina/mcp-servers' 克隆到本地。
  3. 进入目录: 打开终端或命令提示符,进入 'mcp-servers/python/mcp-system-cleaner' 目录。
  4. 安装依赖: 虽然文档中未明确指出,但根据代码 'from mcp.server.fastmcp import FastMCP' 判断,可能需要安装 'mcp-server-sdk' 库。如果运行服务器时提示缺少依赖,请尝试运行命令安装:'pip install mcp-server-sdk'。

服务器配置

MCP客户端需要配置以下信息以连接到系统清理MCP服务器。以下是一个JSON格式的配置示例,请根据您的实际情况进行配置:

{
  "server_name": "system_cleaner",  // 服务器名称,用于客户端识别和管理
  "command": "python",             // 启动服务器的命令,这里使用 python 解释器
  "args": ["server.py"],           // 启动命令的参数,指向服务器脚本 server.py
  "transport": "stdio"            // 通信协议,使用标准输入输出 (stdio)
}
  • 'server_name': 为服务器指定一个易于识别的名称,例如 "system_cleaner"。
  • 'command': 运行服务器程序的可执行命令。由于服务器是 Python 脚本,这里设置为 "python"。
  • 'args': 传递给 'command' 的参数列表。'["server.py"]' 表示执行当前目录下的 'server.py' 文件。
  • 'transport': 指定 MCP 客户端与服务器之间的通信方式。'"stdio"' 表示使用标准输入和输出流进行通信,这是一种简单且常用的方式。

注意: 请确保 MCP 客户端能够找到 'python' 命令以及 'server.py' 脚本的相对路径是正确的。如果 'python' 不在系统 PATH 环境变量中,您可能需要提供 'python' 的完整路径。

基本使用方法

  1. 启动服务器: 在 'mcp-servers/python/mcp-system-cleaner' 目录下,使用终端或命令提示符运行命令 'python server.py' 启动服务器。服务器默认使用 'stdio' 传输协议,并在终端输出日志信息。
  2. 客户端请求: 配置并启动 MCP 客户端,客户端会根据配置信息连接到运行中的系统清理MCP服务器。
  3. 调用工具: 客户端可以使用 MCP 协议向服务器发送 JSON-RPC 请求,调用服务器提供的各种工具,例如 'get_system_status'、'scan_system'、'clean_files' 等,实现系统清理功能。
  4. 查看结果: 服务器执行工具后,会将结果以 JSON-RPC 响应的形式返回给客户端。客户端解析响应,即可获取系统状态、扫描结果、清理报告等信息。

请参考 'python/mcp-system-cleaner/server.py' 文件中的代码注释和工具函数定义,了解每个工具的详细功能和参数。

信息

分类

桌面与硬件