Disk Usage MCP Server (Demo)

@u1i

Disk Usage MCP Server (Demo) について

概要はまだありません

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.

よくある質問

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.