System Information MCP Server

A modular FastMCP server providing focused system diagnostic tools for efficient troubleshooting and environment analysis. Each tool targets specific system aspects for optimal performance and clarity.

🚀 Features

📊 Modular Tool Design

10 specialized tools for targeted diagnostics
Efficient data collection with minimal overhead
Raw text output for optimal performance
Cross-platform compatibility (macOS, Linux, Windows)

🔧 Available Tools

Tool	Purpose	Key Information
`get_system_summary`	Quick system overview	Hostname, OS, CPU, RAM, uptime
`get_hardware_details`	Comprehensive hardware specs	CPU cores, memory, GPU detection
`get_display_info`	Display/monitor analysis	Resolution, refresh rate, HDR status
`get_network_status`	Network diagnostics	Interfaces, IPs, DNS, VPN detection
`get_storage_analysis`	Storage overview	Disk usage, partitions, filesystem types
`get_connected_devices`	Peripheral inventory	USB and Bluetooth devices
`get_user_environment`	Session context	User info, timezone, locale settings
`get_running_processes`	Process analysis	Top processes by CPU/memory usage
`get_open_ports`	Network security	Listening ports and services
`get_full_system_report`	Complete analysis	All diagnostics in one comprehensive report

Installation

# Clone and setup git clone <repository> cd mcp-sysinfo # Install dependencies uv add fastmcp psutil requests # Test the server uv run python main.py

Usage

MCP Configuration

Add to your MCP client configuration:

Local/stdio Configuration

{ "mcpServers": { "sysinfo": { "type": "stdio", "command": "uv", "args": ["run", "--directory", "/path/to/mcp-sysinfo", "python", "main.py"] } } }

Remote/HTTP Configuration

{ "mcpServers": { "sysinfo": { "type": "http", "url": "http://localhost:8000/mcp/" } } }

For HTTP mode, set the PORT environment variable:

PORT=8000 uv run python main.py

Tool Usage Examples

Quick System Check

# Get essential system overview result = await client.call_tool("get_system_summary", {})

Targeted Diagnostics

# Network troubleshooting network_info = await client.call_tool("get_network_status", {}) # Storage analysis storage_info = await client.call_tool("get_storage_analysis", {}) # Security audit ports_info = await client.call_tool("get_open_ports", {})

Complete System Analysis

# Full diagnostic report full_report = await client.call_tool("get_full_system_report", {})

Platform Support

macOS 10.15+ (tested on Apple Silicon)
Linux Ubuntu/Debian-based distributions
Windows 10/11 (basic support)

Architecture

src/sysinfo/ ├── __init__.py # Package exports ├── collectors.py # Modular info collection functions └── server.py # FastMCP server implementation main.py # Entry point

Key Design Principles

Modular Tools: Each diagnostic function is a separate MCP tool for targeted usage
Performance Optimized: Raw text output without JSON wrapping overhead
Error-resilient: Graceful handling of missing/inaccessible data
Cross-platform: Platform-specific detection with intelligent fallbacks
Agent-friendly: Clean markdown output optimized for LLM consumption
Minimal Dependencies: Uses only fastmcp, psutil, and requests

Development

Testing

# Test with in-memory client uv run python test_refactored.py # Test individual collectors uv run python -c "from src.sysinfo.collectors import get_hardware_info; print(get_hardware_info())"

Adding New Collectors

Add function to collectors.py
Export in __init__.py
Call from server.py tool
Test cross-platform compatibility

License

MIT License - see LICENSE file for details.

Deploy Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Tools

View all tools

System Information MCP Server

System Information MCP Server

🚀 Features

📊 Modular Tool Design

🔧 Available Tools

Installation

Usage

MCP Configuration

Local/stdio Configuration

Remote/HTTP Configuration

Tool Usage Examples

Quick System Check

Targeted Diagnostics

Complete System Analysis

Platform Support

Architecture

Key Design Principles

Development

Testing

Adding New Collectors

License

Related Resources

Tools

Appeared in Searches

New MCP Servers

MCP directory API