@purplesquirrel/apple-system-mcp
v0.1.0
Published
MCP server for macOS system tools — Finder Tags, PDF/Preview, Disk Utility, Activity Monitor via AppleScript and shell commands
Downloads
14
Readme
apple-system-mcp
MCP server for macOS system tools — Finder Tags, PDF/Preview, Disk Utility, Activity Monitor.
Install
npm install && npm run buildUsage
npm startTools (12)
Finder Tags
| Tool | Description |
|------|-------------|
| finder_tag_file | Add a color tag (Red, Orange, Yellow, Green, Blue, Purple, Gray) to a file/folder |
| finder_list_tagged | List all files with a specific tag via Spotlight |
| finder_remove_tag | Remove a tag from a file |
Preview / PDF
| Tool | Description |
|------|-------------|
| preview_annotate | Add text annotation to a PDF at a specified position |
| preview_merge_pdfs | Merge multiple PDFs into one |
| preview_pdf_to_images | Convert PDF pages to PNG/JPEG/TIFF images |
Disk Utility
| Tool | Description |
|------|-------------|
| disk_health | SMART status and disk health for all drives |
| disk_usage_top | Find top 20 largest files/dirs in a path |
| disk_info | Detailed info for all mounted volumes |
Activity Monitor
| Tool | Description |
|------|-------------|
| process_list | Top processes by CPU or memory usage |
| process_kill | Kill a process by name or PID |
| memory_pressure | Memory pressure level and swap usage |
Requirements
- macOS (uses AppleScript, diskutil, system_profiler, vm_stat)
- Node.js 18+
- python3 (for PDF tools — PyPDF2/reportlab for annotations, Quartz for conversions)
