mcp-server-disk-usage

mcp-server-disk-usage

0
os_automation

The Disk Usage MCP Server is a demonstration project that integrates with Claude Desktop to check disk usage on macOS in real-time. It serves as an example of developing an MCP server using Python and structuring data to be consumed by AI models. The project highlights capabilities like real-time system monitoring and AI communication.

Disk Usage MCP Server Demo

What is MCP?

Model Context Protocol (MCP) allows AI models like Claude to interact with external tools, providing real-time system information.

What You Get

With integration to Claude Desktop, this demo server enables Claude to check Mac disk usage in real-time.

How It Works

Server Capabilities

The server communicates its tool capabilities (like get_disk_usage) to Claude via MCP protocol.

Communication Protocol

Utilizes JSON-RPC over WebSocket for persistent, bidirectional communication.

Running the Server

  1. Clone the repository.
  2. Install dependencies.
  3. Run the server.

Claude Desktop Integration

Configure Claude Desktop to recognize the MCP server to utilize the disk-usage tool.

Requirements

  • macOS
  • Python 3.11+

Learning Outcomes

Learn how to create an MCP server, integrate system commands, and provide data structured for AI.