MCP Server Practice

🚀 MCP System Resource Monitoring Server

This project is an MCP server based on Spring AI, used to monitor and provide resource information of the host system. It supports multiple operating systems (Linux, macOS, Windows) and provides AI models with the function of obtaining system resource information.

🚀 Quick Start

The MCP System Resource Monitoring Server is designed to monitor and offer resource information of the host system. It supports multiple operating systems and provides AI models with the ability to access system resource data.

✨ Features

1. System Resource Information Monitoring

   • CPU usage information
   • Memory usage information
   • System information such as the number of processors

2. Top CPU-Using Process Information Provision

   • Identification of the processes consuming the most CPU
   • Provision of process ID, name, CPU/memory usage, and running time information

3. Multi-Operating System Support

   • Linux
   • macOS
   • Windows

🔧 Technical Details

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

📦 Installation

Prerequisites

• JDK 24 or higher
• Maven 3.6 or higher

Build and Run

1. Clone the project

   git clone <repository-url>
   cd example-server
   

2. Build with Maven

   ./mvnw clean package
   

3. Start the server

   ./mvnw spring-boot:run
   

💻 Usage Examples

The MCP server provides the following tools:

Query System Resource Information

Get the CPU and memory usage information of the current host.

Example response:

System resource information:

CPU information:
- Available processors: 8
- System CPU usage: 15.75%
- Process CPU usage: 2.13%

Memory information:
- Total memory: 16384 MB
- Available memory: 8472 MB
- Used memory: 7912 MB
- Memory usage: 48.29%

Query Top CPU-Using Process Information

Get information about the process that consumes the most CPU resources on the current host.

Example response:

The current process consuming the most CPU:

PID: 1234
Name: chrome
CPU usage: 25.3%
Memory usage: 1250 MB
Running time: 120 minutes

⚠️ Important Note

• This project is simple code created for testing the functionality of MCP and may not run correctly in different environments.
• External commands need to be executed when obtaining system resource information, so make sure the relevant commands are available.