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 的功能而簡單創建的代碼，可能在不同環境中無法正常運行。

💡 使用建議

獲取系統資源信息時需要執行外部命令，因此必須確保相關命令可用。