disk-space-monitor
Disk Space Monitor — MCP Server
Небольшой сервер для Model Context Protocol, который позволяет ИИ-ассистенту проверять использование дискового пространства на машине, где он запущен. Укажите Claude Desktop (или любой MCP-клиент) на него, и вы сможете спросить "не заполняется ли мой диск?" и получить реальный ответ вместо догадки.
Кроссплатформенный (Windows / macOS / Linux), без конфигурационных файлов, без доступа к сети, без телеметрии.
Инструменты
Инструмент | Аргументы | Что делает |
|
| Сканирует каждый смонтированный раздел и отмечает всё выше порога. |
|
| Детальный отчёт для одного пути или диска, плюс рекомендации. |
|
| Однострочная оценка здоровья по всем разделам. |
Уровни состояния
Уровень | Условие | Маркер |
OK | ниже | 🟢 |
WARNING | на уровне или выше | 🟠 |
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%)Требования
Установка
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.jsonmacOS —
~/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
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Related MCP Servers
- AlicenseAqualityDmaintenanceExposes 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.12GPL 3.0
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to query real-time system metrics like CPU, RAM, disk, and battery usage, and check performance thresholds.-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to monitor real-time CPU, RAM, and disk usage on the local machine.-
- AlicenseAqualityCmaintenanceProvides 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.151MIT