MCP Server Disk Usage

🚀 磁盤使用情況工具

這是一款簡單易用的工具，專門用於獲取並展示 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. 如何提供清晰易懂的人類可讀的摘要信息。