MCP Monitor

The MCP system monitoring tool provides real-time system indicator queries through the MCP protocol

Monitoring Developer tools #System Monitoring #MCP Protocol #Performance Indicators #Real-time Query .Go

rating : 2.5 points

downloads : 5.8K

update time : 2025-04-29

Open Site

What is the MCP System Monitoring Server?

The MCP System Monitoring Server is a tool based on the Model Context Protocol (MCP) used to obtain various indicators of a computer system in real-time, such as CPU, memory, disk, network, and process status. It allows users to obtain detailed system running status in a simple way.

How to use the MCP System Monitoring Server?

Users only need to start the server and connect to an application that supports the MCP protocol to start obtaining system information. The server provides various tools to view the real-time status of the CPU, memory, disk, network, and processes.

Applicable Scenarios

It is suitable for developers, operation and maintenance personnel who need to monitor computer performance in real-time, and anyone interested in the system status. For example, developers can use this tool to optimize code performance, and operation and maintenance personnel can quickly diagnose server problems.

Main Features

CPU Information

Obtain CPU usage, the number of cores, and detailed information.

Memory Information

Display the usage of virtual memory and swap memory.

Disk Information

Query the disk usage of a specified path and support viewing information of all partitions.

Network Information

Obtain network interfaces, traffic statistics, and connection status.

Host Information

Display detailed system information, running time, startup time, and online users.

Process Information

List currently running processes and support sorting by CPU, memory, etc.

Advantages

Monitor system performance in real-time to help quickly locate problems.

Support multiple query methods to meet different needs.

Lightweight design with low resource consumption.

Open source and easy to deploy.

Limitations

Require the installation of a dependent environment (such as Python or Go).

Some advanced functions may require higher permissions.

Do not support cross-platform graphical interfaces.

How to Use

Install the Server

Clone the project repository and compile the source code.

Start the Server

Run the generated binary file to start listening for requests.

Connect the Client

Ensure that the client is configured with the MCP protocol and connected to the server.

Usage Examples

Obtain CPU Usage

Call the get_cpu_info tool to view the overall CPU utilization.

Monitor Disk Usage

Query the disk usage status under a specific path.

List All Processes

Obtain basic information about all active processes in the system.

Frequently Asked Questions

How to install the MCP System Monitoring Server?

Does it support the Windows system?

Can the monitoring frequency be customized?

Related Resources

Official GitHub Repository

Visit the project homepage to obtain the latest version and documentation.

Join the Discord Community

Participate in discussions and technical exchanges.

User Manual

Download the help document in PDF format.

🚀 MCP System Monitoring Tool

A system monitoring tool that exposes system metrics via the Model Context Protocol (MCP). This tool allows Large Language Models (LLMs) to retrieve real-time system information through MCP-compatible interfaces.

🚀 Quick Start

First, clone the repository and build the project:

git clone https://github.com/seekrays/mcp-monitor.git
cd mcp-monitor
make build

Then, run the compiled binary file:

./mcp-monitor

The server starts in standard I/O mode and is ready to communicate with MCP-compatible LLM clients.

✨ Features

This tool provides the following monitoring capabilities:

CPU Information: Usage percentage, number of cores, and detailed CPU information.
Memory Information: Virtual and swap memory usage.
Disk Information: Disk usage, partitions, and I/O statistics.
Network Information: Network interfaces, connections, and traffic statistics.
Host Information: System details, uptime, and users.
Process Information: Process list, sorting, and detailed statistics for each process.

📦 Installation

git clone https://github.com/seekrays/mcp-monitor.git
cd mcp-monitor
make build

💻 Usage Examples

Basic Usage

Run the compiled binary to start the server:

./mcp-monitor

📚 Documentation

Provided Tools

1. CPU Information

Tool: get_cpu_info
Description: Get CPU information and usage.
Parameters:
  - per_cpu (boolean, default: false): Whether to return data for each core.

2. Memory Information

Tool: get_memory_info
Description: Get system memory usage information.
Parameters: None

3. Disk Information

Tool: get_disk_info
Description: Get disk usage information.
Parameters:
  - path (string, default: "/"): Specify the disk path to query.
  - all_partitions (boolean, default: false): Whether to return information for all partitions.

4. Network Information

Tool: get_network_info
Description: Get network interface and traffic information.
Parameters:
  - interface (string, optional): Specify the name of the network interface to query.

5. Host Information

Tool: get_host_info
Description: Get host system information.
Parameters: None

6. Process Information

Tool: get_process_info
Description: Get process information.
Parameters:
  - pid (number, optional): Get detailed information for a specific process by specifying the process ID.
  - limit (number, default: 10): Limit the number of processes returned.
  - sort_by (string, default: "cpu"): Sorting field (cpu, memory, pid, name).