Disk Space Monitor — MCP Server

Небольшой сервер для Model Context Protocol, который позволяет ИИ-ассистенту проверять использование дискового пространства на машине, где он запущен. Укажите Claude Desktop (или любой MCP-клиент) на него, и вы сможете спросить "не заполняется ли мой диск?" и получить реальный ответ вместо догадки.

Кроссплатформенный (Windows / macOS / Linux), без конфигурационных файлов, без доступа к сети, без телеметрии.

Инструменты

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

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.