About mcp-monitor

This server gives AI assistants real-time access to your local system stats using tools for CPU load, memory, disk space, network traffic, and active programs. Connect it to your favorite AI app to quickly check hardware health and track daily performance.

Tools (6)

get_cpu_info

Get CPU information and usage

per_cpu

get_memory_info

Get system memory usage information

get_disk_info

Get disk usage information

pathall_partitions

get_network_info

Get network interface and traffic information

interface

get_host_info

Get host system information

get_process_info

Get process information

pidlimitsort_by

README

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

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 network interface name 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): 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

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

Usage

Run the compiled binary:

./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.

mcp-monitor