Skip to content

SystemMind MCP

Jump to bottom
Ashfaq edited this page Oct 4, 2025 · 1 revision

🧠 SystemMind MCP

Universal OS Information & Diagnostic Toolkit

SystemMind MCP is a cross-platform system intelligence agent that provides deep insights into your machine’s health, performance, and environment — powered by FastMCP. It runs seamlessly on Windows, macOS, and Linux, with auto-detection for containerized contexts (Docker/Podman).

⚙️ Core Features

Category Description
🧩 OS Detection Detects system, kernel, architecture, and configures OS-specific commands
📊 System Health Monitors CPU, Memory, Disk, and Network usage in real-time
🧹 Cleanup Utilities Identifies large files and temporary data to free up space
🔋 Power & Battery Reports battery status, charge cycles, and power settings
🧠 Performance Diagnosis Detects bottlenecks and provides actionable recommendations
🔒 Security Audit Checks active antivirus/firewall tools and computes a security score
🧍 User Insight Lists logged-in users, sessions, and system environment
🔗 Network Overview Scans interfaces, IPs, connections, and usage statistics
🚀 Startup Analysis Displays auto-launch programs and boot impact
🧰 Universal Tools Works across major OSes with one consistent API

🖥️ Available Tools

System Information & Diagnostics

  • initialize_os_connection – Initialize and detect OS details
  • get_system_overview – Get full CPU, memory, disk, and uptime summary
  • get_running_processes – Show top processes with categories
  • get_resource_monitor – Live CPU, memory, disk, and network monitor
  • diagnose_slow_performance – Detect bottlenecks and suggest fixes
  • get_performance_summary – System health snapshot

Storage & Cleanup

  • get_disk_usage – Analyze storage partitions and space usage
  • find_large_files – Find large files in directories
  • clean_temp_files – Remove temporary files safely

Networking

  • get_network_info – Interface details, IPs, and active connections

Power & Environment

  • get_battery_info – Battery charge and time-to-full/empty
  • get_power_settings – Power profiles and CPU frequency states
  • get_temperature_info – CPU/GPU sensor temperatures (when supported)

Security & Services

  • check_security_status – Verify firewall/AV and system update status
  • get_system_services – Lists background system daemons/services

User & Startup

  • get_user_info – Logged-in users and environment details
  • check_startup_programs – Auto-start programs and memory footprint

🧭 Getting Started

1️⃣ Install dependencies

pip install -r requirements.txt

2️⃣ Run the server

python OS_mcp_server.py

🧑‍💻 Developer Notes

  • Built with FastMCP for structured multi-tool endpoints.
  • Each function decorated with @mcp.tool is directly callable via MCP clients.
  • Uses psutil for cross-platform system insights.
  • Safe execution: read-only by default; cleanup functions support dry_run=True.

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/new-tool)
  3. Commit changes (git commit -m "Add new tool: get_gpu_info")
  4. Push to the branch (git push origin feature/new-tool)
  5. Open a Pull Request

⚖️ License

This project is open-source under the MIT License. Feel free to use, modify, and distribute with attribution.

🌟 Credits

Developed and maintained by Ashfaq Full Stack & Applied AI Engineer — Bangalore, India

Clone this wiki locally