🚀 磁盘使用情况工具

这是一款简单易用的工具，专门用于获取并展示 macOS 系统的磁盘使用情况信息。它借助 MCP 协议运行，并且已经集成到 Claude Desktop 中，为用户提供便捷的磁盘使用监控体验。

✨ 主要特性

• 实时数据：能够监控特定分区的实时使用情况，让用户随时掌握磁盘动态。
• 详细信息：提供详细的磁盘使用信息，涵盖已用空间、可用空间、保留空间和使用百分比等，满足用户对磁盘信息的全面需求。
• 特定于 macOS：专门针对 Mac 系统的/System/Volumes/Data分区设计，确保在 macOS 系统上的精准使用。

📦 安装指南

环境要求

• 操作系统：macOS（该工具专为 Mac 设计）
• Python 版本：3.11+
• 依赖管理工具：pip

安装步骤

1. 克隆此仓库到本地。
2. 在终端中运行以下命令安装所需的 Python 包：

pip install -r requirements.txt

3. 启动服务器：

python disk_usage_server.py

⚠️ 重要提示

此服务器专门针对 Mac 的/System/Volumes/Data分区（即 disk3s5）设计，无法在其他操作系统上运行。

集成到 Claude Desktop

1. 在 Claude Desktop 的配置目录下创建一个名为claude-config.txt的文件。
2. 将以下内容粘贴到该文件中：

{
  "mcpServers": {
    "disk-usage": {
      "command": "python3",
      "args": [
        "<你的实际路径>/disk_usage_server.py"
      ]
    }
  }
}

3. 将<你的实际路径>替换为实际保存服务器文件的位置。
4. 重启 Claude Desktop 以应用配置。

💻 使用示例

基础用法

import subprocess
import json
from datetime import datetime, timezone
from http.server import BaseHTTPRequestHandler, HTTPServer

class DiskUsageRequestHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        # 确定要查询的分区（此处为Mac的/System/Volumes/Data）
        target_partition = '/System/Volumes/Data'
        
        try:
            # 使用df命令获取磁盘使用情况
            result = subprocess.run(['df', '-h'], capture_output=True, text=True, check=True)
            
            # 解析df命令的输出
            output_lines = result.stdout.split('\n')
            for line in output_lines:
                if target_partition in line:
                    break
            
            # 提取所需信息
            parts = line.strip().split()
            total_space = parts[1]
            used_space = parts[2]
            available_space = parts[3]
            use_percentage = parts[4]
            mounted_on = parts[5]
            
            # 返回结构化数据
            response = {
                "device": target_partition,
                "total_gb": total_space,
                "used_gb": used_space,
                "available_gb": available_space,
                "use_percentage": use_percentage,
                "mounted_on": mounted_on,
                "timestamp": datetime.now(timezone.utc).isoformat()
            }
            
            self.send_response(200)
            self.send_header('Content-Type', 'application/json')
            self.end_headers()
            self.wfile.write(json.dumps(response).encode())
            
        except subprocess.CalledProcessError as e:
            # 处理df命令执行失败的情况
            error = {
                "error": str(e),
                "timestamp": datetime.now(timezone.utc).isoformat()
            }
            self.send_response(500)
            self.send_header('Content-Type', 'application/json')
            self.end_headers()
            self.wfile.write(json.dumps(error).encode())
    
if __name__ == "__main__":
    server_address = ('', 8080)

📚 详细文档

项目结构

• disk_usage_server.py：主要的 MCP 服务器实现文件。
• requirements.txt：Python 依赖管理文件。
• claude-config.txt：示例 Claude Desktop 配置文件，用于指定 MCP 服务器的位置和运行参数。

🔧 技术细节

通过此项目，可以学习到以下内容：

1. 如何使用 Python 创建一个简单的 MCP 服务器。
2. 如何将系统命令集成到 MCP 工具中。
3. 如何为 AI 设计结构化的数据输出格式。
4. 如何处理特定于操作系统的细节（如分区信息）。
5. 如何提供清晰易懂的人类可读的摘要信息。