返回 MCP 目录
public公开dns本地运行

MCP-Server-Practice

Spring AI 기반의 MCP 서버로, 다양한 운영체제에서 시스템 리소스를 모니터링하고 AI 모델에 정보를 제공하는 프로젝트입니다.

article

README

🚀 MCP 系统资源监控服务器

本项目是基于 Spring AI 的 MCP 服务器,专注于监控并提供主机系统的资源信息。它支持 Linux、macOS、Windows 等多种操作系统,能为 AI 模型提供便捷的系统资源信息获取功能。

✨ 主要特性

  1. 系统资源信息监控

    • 精准获取 CPU 使用率信息。
    • 实时掌握内存使用量信息。
    • 提供处理器数量等系统信息。
  2. 顶级 CPU 使用进程信息提供

    • 快速识别最消耗 CPU 的进程。
    • 详细提供进程 ID、名称、CPU/内存使用率、运行时间等信息。
  3. 多种操作系统支持

    • 支持 Linux 系统。
    • 支持 macOS 系统。
    • 支持 Windows 系统。

🔧 技术细节

  • Java 24:提供强大的编程能力和运行环境。
  • Spring Boot 3.4.4:简化项目开发和部署流程。
  • Spring AI MCP Server:为系统提供 AI 相关的核心功能。
  • Maven:用于项目的依赖管理和构建。

📦 安装指南

先决条件

  • 需安装 JDK 24 及以上版本。
  • 需安装 Maven 3.6 及以上版本。

构建与运行

  1. 项目克隆
    git clone <repository-url>
    cd example-server
    
  2. Maven 构建
    ./mvnw clean package
    
  3. 服务器启动
    ./mvnw spring-boot:run
    

💻 使用示例

系统资源信息查询

获取当前主机的 CPU 及内存使用量信息

响应示例:

系统资源信息:

CPU 信息:
- 可用处理器:8 个
- 系统 CPU 使用率:15.75%
- 进程 CPU 使用率:2.13%

内存 信息:
- 总内存:16384 MB
- 可用内存:8472 MB
- 使用中的内存:7912 MB
- 内存使用率:48.29%

顶级 CPU 使用进程信息查询

获取当前主机中消耗最多 CPU 资源的进程信息

响应示例:

当前消耗最多 CPU 的进程:

PID: 1234
名称: chrome
CPU 使用量:25.3%
内存使用量:1250 MB
运行时间:120 分钟

⚠️ 重要提示

  • 该项目是为了测试 MCP 的功能而简单创建的代码,可能在不同环境中无法正常运行。
  • 获取系统资源信息时需要执行外部命令,因此必须确保相关命令可用。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端