trackmcp
Back to directory
oh980225

mcp-server-practice

View on GitHub

MCP Server Practice

0 stars JavaServers & Infrastructure Updated Apr 1, 2025

Documentation

MCP 시스템 리소스 모니터링 서버

이 프로젝트는 Spring AI 기반의 MCP 서버로, 호스트 시스템의 리소스 정보를 모니터링하고 제공하는 기능을 구현합니다. 다양한 운영체제(Linux, macOS, Windows)를 지원하며, AI 모델이 시스템 리소스 정보를 요청할 수 있는 도구를 제공합니다.

주요 기능

1. 시스템 리소스 정보 모니터링

    2. 최상위 CPU 사용 프로세스 정보 제공

      3. 다양한 운영체제 지원

        기술 스택

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

        설치 및 실행 방법

        사전 요구사항

        • JDK 24 이상
        • Maven 3.6 이상

        빌드 및 실행

        1. 프로젝트 클론

        bash
        git clone 
           cd example-server

        2. Maven으로 빌드

        bash
        ./mvnw clean package

        3. 서버 실행

        bash
        ./mvnw spring-boot:run

        API 사용 예시

        MCP 서버는 다음과 같은 도구를 제공합니다:

        시스템 리소스 정보 조회

        code
        현재 호스트의 CPU 및 메모리 사용량 정보를 조회합니다

        응답 예시:

        code
        시스템 리소스 정보:
        
        CPU 정보:
        - 사용 가능한 프로세서: 8개
        - 시스템 CPU 사용률: 15.75%
        - 프로세스 CPU 사용률: 2.13%
        
        메모리 정보:
        - 전체 메모리: 16384 MB
        - 사용 가능한 메모리: 8472 MB
        - 사용 중인 메모리: 7912 MB
        - 메모리 사용률: 48.29%

        최상위 CPU 사용 프로세스 정보 조회

        code
        현재 호스트에서 가장 많은 CPU 자원을 사용하는 프로세스 정보를 조회합니다

        응답 예시:

        code
        현재 가장 많은 CPU를 사용 중인 프로세스:
        
        PID: 1234
        이름: chrome
        CPU 사용량: 25.3%
        메모리 사용량: 1250 MB
        실행 시간: 120분

        주의 사항

        • MCP 의 동작을 확인하고 싶어 간단히 만든 코드로 환경별로 정상적인 동작을 하지않을 수 있습니다.
        • 시스템 리소스 정보를 가져오기 위해 외부 명령어를 실행하므로, 해당 명령어가 사용 가능한 환경이어야 합니다.

        Frequently asked questions

        What is mcp-server-practice?

        mcp-server-practice is MCP Server Practice

        How do I install mcp-server-practice?

        Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

        Is mcp-server-practice open source?

        Yes — it is hosted on GitHub at https://github.com/oh980225/MCP-Server-Practice.

        Related MCP tools

        Run your own MCP server? See who uses it and what to fix.

        Measure it with TrackMCP