davidwadsworth80/get-system-resources repository overview

⁠get-system-resources

A cross-platform Model Context Protocol (MCP) server that provides comprehensive system resource inspection capabilities. This Docker container delivers on-demand snapshots of CPU, memory, disk, GPU, and network status, making it ideal for diagnostics, monitoring, and troubleshooting across different operating systems.

⁠Features

• Cross-Platform Support: Works on Windows, macOS, and Linux hosts
• Comprehensive Resource Monitoring:
  • CPU utilization, core details, and topology
  • Memory usage (virtual and swap)
  • Disk space and usage statistics
  • GPU information (NVIDIA, AMD, Apple Silicon)
  • Network interfaces and traffic
  • System information
• MCP Integration: Built with FastMCP for seamless integration with MCP-compatible clients
• Real-time Data: Provides current system resource snapshots
• Structured Output: Returns well-typed, structured data using Pydantic models

⁠Quick Start

⁠Pull the Image

docker pull davidwadsworth80/get-system-resources:latest

⁠Run the Container

To run the MCP server in a container with access to host system resources:

docker run --rm -it \
  --privileged \
  --pid=host \
  --network=host \
  davidwadsworth80/get-system-resources:latest

Note: The --privileged, --pid=host, and --network=host flags are required for the container to access system resources like CPU, memory, disk, and network information.

⁠Usage

The container runs the MCP server, which provides the following tools:

• get_cpu(): Detailed CPU information
• get_memory(): Memory statistics
• get_disk(): Disk usage information
• get_gpu(): GPU device information
• get_network(): Network interface details
• get_system(): General system information
• get_all(): Comprehensive snapshot of all resources
• get_capabilities(): System monitoring capabilities
• get_version(): Server version

Integrate this container with MCP-compatible clients such as Claude Desktop or other MCP-enabled applications.

⁠Configuration

No additional configuration is required. The server automatically detects available system resources.

⁠Requirements

• Docker
• Host system with supported OS (Windows, macOS, Linux)

⁠Support

For issues, questions, or contributions, please visit the GitHub repository⁠.

⁠License

This project is licensed under the Apache License 2.0.