MCP Monitor

🚀 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).

🤝 Contribution

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