Device

Provides device data such as system specs, battery, storage, and memory across platforms.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jahidhasanco-devicemcp": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "PYTHONPATH": "/opt/devicemcp/lib"
      }
    }
  }
}

DeviceMCP is a cross‑platform MCP server that exposes device information such as system specs, battery status, storage, and memory details for Windows, macOS, Linux, and Android. It enables you to query up‑to‑date data from client applications and scripts, helping you monitor and manage devices across environments.

How to use

You connect to DeviceMCP with an MCP client and run the server in either local (stdio) mode or via an HTTP transport when you need network access. Start by launching the server, then query the available data endpoints to retrieve comprehensive device information, battery status, storage details, memory usage, and a full system summary.

How to install

Prerequisites: Python 3.8 or higher and a package manager (pip or uv). Ensure Python is available on your system before proceeding.

pip install -r requirements.txt

Alternatively, using uv:

uv pip install -r requirements.txt

Android (Termux) users can install Python and the required MCP packages with these commands:

pkg install python
pip install fastmcp psutil pydantic
# Optional: Install termux-api for better battery info
pkg install termux-api

Run locally using the standard Python entry point or via the FastMCP CLI.

python server.py

fastmcp run server.py:mcp

To expose the server over HTTP, start with the HTTP transport and a port of your choosing.

python server.py --transport http --port 8000

fastmcp run server.py:mcp --transport http --port 8000

If you want to integrate DeviceMCP with Claude Desktop, generate the configuration for the MCP client installation.

fastmcp install server.py:mcp --name DeviceMCP

Additional notes and tips

Battery information may be unavailable on systems without a battery. In such cases, the server indicates that no battery data is present.

Some drives or partitions may require elevated permissions to access storage information. The server will skip inaccessible drives without failing.

On Android, for best battery info, install termux-api as shown above.

Available tools

get_device_info

Fetches comprehensive device information including OS, hostname, architecture, processor, and platform.

get_battery_level

Returns current battery percentage, charging status, and time remaining.

get_storage_info

Provides storage statistics for all drives/partitions including total, used, free, and usage percentage.

get_memory_info

Reports RAM and swap memory usage, totals, and formatted representations.

get_system_summary

Returns a combined summary of all available device information, including platform detection.