项目简介

Systems-Manager 是一个功能强大的跨平台系统管理工具，支持 Windows、Ubuntu、Debian、Red Hat、Oracle Linux、SLES 和 Arch 等多种操作系统。它不仅提供命令行界面，还集成了 Model Context Protocol (MCP) 服务器功能，使其能够与 AI 和自动化系统无缝集成，远程管理系统任务。

主要功能点

跨操作系统支持: 兼容 Windows 和多种主流 Linux 发行版。
应用管理: 使用原生包管理器（如 apt, dnf, winget 等）安装和更新应用程序，Linux 系统支持 Snap 自动回退。
Python 模块安装: 方便地安装和升级 Python 包。
字体安装: 支持安装指定或全部 Nerd Fonts 字体。
系统维护与优化: 执行系统清理（如垃圾桶/回收站）、资源优化（如自动删除不必要文件、Windows 碎片整理）。
Windows 功能管理: 在 Windows 系统上列出、启用或禁用可选功能（仅限 Windows）。
系统与硬件统计: 获取详细的操作系统和硬件性能数据。
MCP 服务器: 将上述所有功能作为工具通过标准 MCP 协议暴露，供 AI 或自动化应用调用。

安装步骤

安装 Python 包: 使用 'pip' 或 'uv' 包管理器安装 'systems-manager' Python 包。

python -m pip install systems-manager
# 或者使用 uv
uv pip install --upgrade systems-manager

依赖项: 安装过程中会自动安装以下 Python 依赖：'distro'（用于 Linux 发行版检测）、'psutil'（用于系统和硬件统计）、'requests'（用于下载 Nerd Fonts）以及 'fastmcp'（用于 MCP 服务器功能）。

MCP 服务器配置

MCP 客户端需要配置服务器信息才能连接。以下是一个标准的 'mcp.json' 配置文件示例，用于指示 MCP 客户端如何启动和连接 Systems-Manager MCP 服务器。

{
  "mcpServers": {
    "systems_manager": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "systems-manager",
        "systems-manager-mcp",
        "--transport",
        "http",
        "--host",
        "0.0.0.0",
        "--port",
        "8003"
      ],
      "env": {
        "SILENT": "False",
        "LOG_FILE": "~/Documents/systems_manager_mcp.log"
      },
      "timeout": 200000
    }
  }
}

'"systems_manager"': 这是一个自定义的服务器名称，MCP 客户端通过此名称识别并连接到该服务器。
'"command"': 指定用于启动 MCP 服务器的命令，这里使用 'uv' 来运行 Python 模块。
'"args"': 传递给 'command' 命令的参数列表，用于控制服务器的启动方式。
- '"run", "--with", "systems-manager", "systems-manager-mcp"': 这些参数指示 'uv' 运行 'systems-manager' 包中的 'systems_manager_mcp' 模块。
- '"--transport", "http"': 指定 MCP 服务器使用 HTTP 传输协议与客户端通信。
- '"--host", "0.0.0.0"': 服务器监听的 IP 地址，'0.0.0.0' 表示监听所有可用的网络接口。
- '"--port", "8003"': 服务器监听的端口号，客户端将通过此端口连接。
'"env"': 运行服务器时可以设置的环境变量，例如：
- '"SILENT": "False"': 控制服务器是否抑制输出到标准输出。
- '"LOG_FILE": "~/Documents/systems_manager_mcp.log"': 指定服务器日志文件的路径。
'"timeout"': 客户端等待 MCP 服务器启动并准备好连接的超时时间（单位为毫秒）。

基本使用方法

安装后，可以直接通过命令行使用 'systems-manager' 工具执行系统管理任务，例如：

systems-manager --fonts Hack,Meslo --update --clean --python geniusbot --install python3,git --enable-features Microsoft-Hyper-V-All,Containers

要作为 MCP 服务器运行，客户端会根据上述 'mcp.json' 配置自动启动。如果需要手动启动 MCP 服务器进行测试或独立运行，可以使用以下命令：

systems-manager-mcp --transport http --host 0.0.0.0 --port 8003

服务器启动后，MCP 客户端即可通过 JSON-RPC 协议调用其暴露的系统管理工具，如 'install_applications'（安装应用）、'update'（更新系统）、'get_os_stats'（获取操作系统统计）等。

关键词

项目简介

主要功能点

安装步骤

MCP 服务器配置

基本使用方法

信息