Disk Usage MCP Server (Demo)

@u1i

About Disk Usage MCP Server (Demo)

No overview available yet

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"
      ]
    }
  }
}

Tools

No tools detected

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

FAQ from Disk Usage MCP Server (Demo)

What operating system is required?

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

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.

What disk partition does it check?

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

What transport protocol does it use?

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

Does the tool require any parameters?

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

Frequently asked questions

What operating system is required?

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

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.

What disk partition does it check?

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

What transport protocol does it use?

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

Does the tool require any parameters?

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

Comments

Basic information

More Other MCP servers

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K