mcp-monitor

mcp-monitor

20
monitoring

MCP System Monitor is a tool designed for real-time system metrics monitoring via the Model Context Protocol, allowing integration with language models. It efficiently tracks various system resources such as CPU, memory, disk, network, host, and process information.

MCP System Monitor

Discord

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