Skip to main content
Glama
disk-space-monitor

disk-space-monitor

Disk Space Monitor — MCP Server

Небольшой сервер для 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

Детальный отчёт для одного пути или диска, плюс рекомендации.

disk_summary

threshold: float = 50.0

Однострочная оценка здоровья по всем разделам.

Уровни состояния

Уровень

Условие

Маркер

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)

  • mcp и psutil

Установка

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.exe и C:/path/to/disk-space-monitor/main.py. Оба пути должны быть абсолютными — сервер запускается напрямую, а не через оболочку.

После этого перезапустите Claude Desktop. Три инструмента появятся автоматически, и вы сможете задавать вопросы вроде:

Не заполняется ли мой диск? Проверь диск D: и предупреди, если он заполнен более чем на 80%. Дай однострочную сводку о состоянии диска.

Запуск в автономном режиме

python main.py

Сервер общается через stdio по протоколу MCP, поэтому прямой запуск просто блокирует выполнение в ожидании клиента — это нормально, а не зависание.


Как это работает

Обнаружение разделов. psutil.disk_partitions(all=False) перечисляет реальные смонтированные разделы, затем пропускаются псевдо-файловые системы, которые часто зависают или не несут значимых данных об использовании: squashfs, tmpfs, devtmpfs, overlay, autofs и записи без указания типа файловой системы.

Защита по тайм-ауту. Каждый раздел считывается внутри потока-демона с тайм-аутом 0,5 секунды. Отключённый сетевой диск или спящий внешний диск могут заставить shutil.disk_usage() блокироваться надолго; если срок истекает, раздел помечается как ⚪ SKIPPED, и сканирование продолжается. Это не позволяет одному проблемному монтированию заморозить весь вызов инструмента.

Форматирование. Размеры отображаются в ГБ ниже 1000 ГБ и в ТБ выше. Индикатор использования имеет ширину 22 символа и ограничен этим диапазоном, поэтому некорректные проценты не могут привести к неконтролируемому выводу.

Структура проекта

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

Конфиденциальность

Сервер считывает только локальные данные об использовании диска — общий, использованный и свободный объём в байтах для каждого раздела, а также название и версию ОС для заголовка отчёта. Он не выполняет сетевых запросов, не записывает файлы, не читает содержимое файлов и ничего не сохраняет между вызовами.

Лицензия

MIT — см. LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    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
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to monitor real-time CPU, RAM, and disk usage on the local machine.
      -
    • A
      license
      A
      quality
      C
      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
      1
      MIT