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
- Maven

설치 및 실행 방법

사전 요구사항

- JDK 24 이상
- Maven 3.6 이상

빌드 및 실행

1. 프로젝트 클론

   git clone <repository-url>

   cd example-server

   

2. Maven으로 빌드

   ./mvnw clean package

   

3. 서버 실행

   ./mvnw spring-boot:run

   

API 사용 예시

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분

주의 사항