MCP Server Practice

🚀 MCP 系统资源监控服务器

本项目是基于 Spring AI 的 MCP 服务器，可监控并提供主机系统的资源信息。它支持 Linux、macOS、Windows 等多种操作系统，能为 AI 模型提供系统资源信息获取功能，助力用户实时掌握系统资源状况。

🚀 快速开始

本 MCP 服务器能为你提供系统资源信息监控等功能。以下是使用前的准备及启动步骤：

先决条件

• JDK 24 及以上版本
• Maven 3.6 及以上版本

构建与运行

1. 项目克隆

   git clone <repository-url>
   cd example-server
   

2. Maven 构建

   ./mvnw clean package
   

3. 服务器启动

   ./mvnw spring-boot:run
   

✨ 主要特性

1. 系统资源信息监控
   • 提供 CPU 使用率信息。
   • 展示内存使用量信息。
   • 提供处理器数量等系统信息。
2. 顶级 CPU 使用进程信息提供
   • 识别最消耗 CPU 的进程。
   • 提供进程 ID、名称、CPU/内存使用率、运行时间信息。
3. 多种操作系统支持
   • 支持 Linux 系统。
   • 支持 macOS 系统。
   • 支持 Windows 系统。

🔧 技术细节

本项目的技术栈如下：

• Java 24
• Spring Boot 3.4.4
• Spring AI MCP Server
• Maven

💻 使用示例

MCP 服务器提供了以下工具，以下为你展示具体的使用示例：

基础用法

系统资源信息查询

获取当前主机的 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 的功能而简单创建的代码，可能在不同环境中无法正常运行。

💡 使用建议

获取系统资源信息时需要执行外部命令，因此必须确保相关命令可用。