MCP Server Disk Usage

🚀 ディスク使用状況ツール

このプロジェクトは、macOSシステムのディスク使用状況情報を取得して表示するための、使いやすいツールです。MCPプロトコルを通じて動作し、Claude Desktopに統合されています。

🚀 クイックスタート

このツールはmacOSシステムのディスク使用状況を取得・表示するためのものです。以下の手順で使用できます。

✨ 主な機能

• リアルタイムデータ: 特定のパーティションのリアルタイム使用状況を監視します。
• 詳細情報: ディスクの使用情報を詳細に提供します。使用済み容量、空き容量、予約容量、使用率などが含まれます。
• macOS専用: Macシステムの/System/Volumes/Dataパーティションを対象に設計されています。

📦 インストール

環境要件

• オペレーティングシステム: 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を再起動して設定を適用します。

📚 ドキュメント

学習成果

このプロジェクトを通じて、以下のことを学ぶことができます。

1. Pythonを使って簡単なMCPサーバーを作成する方法
2. システムコマンドをMCPツールに統合する方法
3. AI用に構造化されたデータ出力形式を設計する方法
4. オペレーティングシステム固有の詳細（パーティション情報など）を扱う方法
5. 人間が理解しやすい明確な要約情報を提供する方法

💻 使用例

基本的な使用法

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)

🔧 技術詳細

プロジェクト構成

1. disk_usage_server.py: 主要なMCPサーバー実装ファイル
2. requirements.txt: Pythonの依存関係管理ファイル
3. claude-config.txt: Claude Desktopの設定ファイルのサンプル。MCPサーバーの位置と実行パラメータを指定します。