Advertise
MCP.so
Sign In

Disk Usage MCP Server (Demo)

@u1i

Repository

Basic information

Category

Other

Last updated

Transports

stdio

Author

u1i

About Disk Usage MCP Server

No overview available yet

#mcp#disk-usage#server

Disk Usage MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-disk-usage": {
      "command": "python",
      "args": [
        "disk_usage_server.py"
      ]
    }
  }
}

Disk Usage MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Disk Usage MCP Server (Demo)?

Disk Usage MCP Server (Demo) is a demo MCP server that enables AI models like Claude to check real-time disk usage on a Mac. It uses the df command to retrieve disk statistics and returns structured data for the system partition.

How to use Disk Usage MCP Server (Demo)?

Clone the repository, install dependencies with pip install -r requirements.txt, and run python disk_usage_server.py. Then configure Claude Desktop by adding a claude-config.txt file with the server’s path in the MCP servers section, and restart Claude Desktop.

Key features of Disk Usage MCP Server (Demo)

  • Provides a single tool: get_disk_usage
  • Returns total, used, available, reserved space in GB
  • Shows usage percentage and mount point
  • Designed specifically for macOS (checks /System/Volumes/Data)
  • Uses Python’s subprocess to run the df command
  • Communicates via bidirectional JSON-RPC over WebSocket

Use cases of Disk Usage MCP Server (Demo)

  • Ask Claude "What is my current disk usage?" and get a formatted response
  • Monitor available disk space without leaving the AI chat
  • Quickly check if disk is near capacity and receive cleanup suggestions

Frequently asked questions

1

What operating system is required?

macOS (the tool is specifically designed for Mac’s disk structure and will not work on other operating systems).

2

How do I integrate with Claude Desktop?

Create a `claude-config.txt` file in the Claude Desktop configuration directory (usually `~/.config/claude-desktop/` on macOS) with the path to the server’s Python file, then restart Claude Desktop.

3

What disk partition does it check?

It specifically looks at the `/System/Volumes/Data` partition (disk3s5 on macOS).

4

What transport protocol does it use?

MCP uses a bidirectional JSON-RPC protocol over WebSocket between the AI client and the server.

5

Does the tool require any parameters?

No, `get_disk_usage` has no required parameters; it returns disk information for the system disk.

Comments

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Courio

Benoit

Mail a real postal letter worldwide from a PDF or text. No account, pay per letter.

Advertise