MCP System Monitor

GitHub release (latest SemVer)

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

Features

This tool provides the following monitoring capabilities:

CPU Information: Usage percentage, core count, and detailed CPU info
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, boot time, and users
Process Information: Process listing, sorting, and detailed per-process statistics

Available Tools

1. CPU Information

Code

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

Code

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

3. Disk Information

Code

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

Code

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

5. Host Information

Code

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

6. Process Information

Code

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

Installation

bash

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

Usage

Run the compiled binary:

bash

./mcp-monitor

The server starts in stdio mode, ready to communicate with an MCP-compatible LLM client.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.