AI 어시스턴트가 실행 중인 시스템의 디스크 사용량을 검사할 수 있게 해주는 작은 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.txtClaude 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서버는 MCP 프로토콜을 사용하여 stdio를 통해 통신하므로, 직접 실행하면 클라이언트를 기다리며 차단됩니다. 이는 예상된 동작이며 멈춤이 아닙니다.
파티션 탐색. psutil.disk_partitions(all=False)는 실제 마운트된 파티션을 나열한 후, 일반적으로 멈추거나 의미 있는 사용량 데이터가 없는 의사 파일 시스템(squashfs, tmpfs, devtmpfs, overlay, autofs 및 파일 시스템 유형이 없는 항목)을 건너뜁니다.
시간 초과 보호. 각 파티션은 0.5초 제한 시간이 있는 데몬 스레드 내에서 읽힙니다. 네트워크 드라이브 연결이 끊어지거나 외부 디스크가 절전 상태인 경우 shutil.disk_usage()가 오랫동안 차단될 수 있습니다. 제한 시간이 지나면 해당 파티션은 ⚪ SKIPPED로 보고되고 스캔이 계속됩니다. 이렇게 하면 단일 결함 마운트로 인해 전체 도구 호출이 중단되지 않습니다.
형식 지정. 크기는 1000GB 미만이면 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 참조.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
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.
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