Skip to main content
Glama
sandhyayadavalli

disk-space-monitor

ディスク容量モニター — MCPサーバー

AIアシスタントが実行中のマシンのディスク使用状況を確認できる、小さなModel Context Protocolサーバーです。Claude Desktop(または任意のMCPクライアント)に接続すれば、*「ディスクがいっぱいになっていない?」*と尋ねて、推測ではなく実際の答えを得られます。

クロスプラットフォーム(Windows / macOS / Linux)、設定ファイル不要、ネットワークアクセス不要、テレメトリなし。


ツール

ツール

引数

機能

check_disk_space

threshold: float = 50.0

マウントされているすべてのパーティションをスキャンし、しきい値を超えたものをフラグ付けします。

check_single_path

path: str, threshold: float = 50.0

1つのパスまたはドライブの詳細レポートとアドバイスを提供します。

disk_summary

threshold: float = 50.0

全パーティションの1行での健全性評価を提供します。

ステータスレベル

レベル

トリガー

マーカー

OK

threshold未満

🟢

WARNING

threshold以上(デフォルト50%)

🟠

CRITICAL

90%以上

🔴

SKIPPED

読み取り不能またはタイムアウト


Related MCP server: Hardware Monitor MCP Server

出力例

disk_summary()

🟢 ALL GOOD — All partitions below 50.0%. System is healthy.

check_single_path("C:\\")

💽  DISK USAGE: C:\
    Windows 11  │  2026-08-17 19:08:44  │  Threshold: 50.0%
─────────────────────────────────────────────────────────────────
  Status  : 🟠 WARNING
  Usage   : [██████████████░░░░░░░░] 63.4%
  Used    :    301.2 GB
  Free    :    173.8 GB
  Total   :    475.0 GB
─────────────────────────────────────────────────────────────────
⚠️  Above 50.0%. Consider archiving old files or clearing caches.

check_disk_space(threshold=70)

💽  DISK SPACE REPORT
    Windows 11  │  2026-08-17 19:08:44  │  Threshold: 70.0%
─────────────────────────────────────────────────────────────────
  🟢 OK        C:\  [NTFS]
           [██████████████░░░░░░░░] 63.4%
           Used     301.2 GB  │  Free     173.8 GB  │  Total     475.0 GB

  🔴 CRITICAL  D:\  [NTFS]
           [████████████████████░░] 92.7%
           Used     927.0 GB  │  Free      73.0 GB  │  Total    1000.0 GB
─────────────────────────────────────────────────────────────────
⚠️  1 critical, 0 warning:
   🔴 D:\ (92.7%)

必要条件

  • Python 3.10以降(3.12で開発)

  • mcppsutil

インストール

git clone https://github.com/<your-username>/disk-space-monitor.git
cd disk-space-monitor

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

pip install -r requirements.txt

Claude Desktopへの接続

Claude Desktopの設定ファイルにサーバーを追加します:

  • Windows%APPDATA%\Claude\claude_desktop_config.json

  • macOS~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "disk-monitor": {
      "command": "/absolute/path/to/disk-space-monitor/.venv/bin/python",
      "args": ["/absolute/path/to/disk-space-monitor/main.py"]
    }
  }
}

Windowsではパスは C:/path/to/disk-space-monitor/.venv/Scripts/python.exeC:/path/to/disk-space-monitor/main.py のようになります。両方のパスは絶対パスである必要があります。サーバーはシェルを介さずに直接起動されます。

その後、Claude Desktopを再起動します。3つのツールが自動的に表示され、次のような質問ができるようになります:

ディスクがいっぱいになっていない? Dドライブをチェックして、80%を超えていたら警告して。 ディスクの健全性を1行で教えて。

スタンドアロンでの実行

python main.py

サーバーはMCPプロトコルを使用してstdio経由で通信するため、直接実行するとクライアントを待機してブロックします。これは想定された動作であり、ハングではありません。


仕組み

パーティションの検出。 psutil.disk_partitions(all=False) で実際にマウントされているパーティションをリストアップし、その後、一般的にハングしたり意味のある使用データを持たない疑似ファイルシステム(squashfstmpfsdevtmpfsoverlayautofs、およびファイルシステムタイプがないエントリ)をスキップします。

タイムアウトガード。 各パーティションは、0.5秒のデッドラインを持つデーモンスレッド内で読み取られます。切断されたネットワークドライブやスリープ状態の外部ディスクがあると、shutil.disk_usage() が長時間ブロックする可能性があります。デッドラインを超えると、そのパーティションは ⚪ SKIPPED として報告され、スキャンは続行されます。これにより、1つの不良マウントがツール呼び出し全体をフリーズさせるのを防ぎます。

フォーマット。 サイズは1000 GB未満ではGB、それ以上ではTBで表示されます。使用率バーは22文字幅で、その範囲にクランプされるため、不正なパーセンテージが異常な出力を生成することはありません。

プロジェクト構造

disk-space-monitor/
├── main.py            # the entire server — helpers + three tools
├── requirements.txt   # mcp, psutil
├── .gitignore
├── LICENSE
└── README.md

プライバシー

サーバーはローカルのディスク使用量(パーティションごとの合計、使用済み、空きバイト数、およびレポートヘッダー用のOS名とバージョン)のみを読み取ります。ネットワークリクエストは行わず、ファイルを書き込まず、ファイルの内容を読み取らず、呼び出し間で何も保存しません。

ライセンス

MIT — LICENSE を参照してください。

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Exposes Windows system information and control tools including hardware stats, network details, and process monitoring. It enables AI applications to retrieve real-time data about CPU, memory, drives, and active system processes.
    12
    GPL 3.0
  • F
    license
    -
    quality
    B
    maintenance
    Enables AI assistants to monitor real-time CPU, RAM, and disk usage on the local machine.
  • A
    license
    A
    quality
    A
    maintenance
    Provides Claude with read-only access to PC diagnostics including hardware specs, live performance metrics, disk usage, network checks, and more, enabling natural language queries about PC health and performance.
    15
    MIT

View all related MCP servers

Related MCP Connectors

  • Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.

  • Live status, API pricing and rate limits for ChatGPT, Claude, Gemini, Cursor and 42+ AI tools.

  • Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandhyayadavalli/disk-space-monitor'

If you have feedback or need assistance with the MCP directory API, please join our Discord server