Advertise
MCP.so
Sign In

Disk Usage MCP Server (Demo)

@u1i

Repository

Basic information

Category

Other

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

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

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.

Advertise