POSIX System MCP Server
A high-performance Model Context Protocol (MCP) server built with Go that provides POSIX system monitoring capabilities for Claude Desktop, Cursor, and other MCP clients.
Features
- System Info: CPU, memory, disk, network, process monitoring
- Real-time: Live system metrics with minimal latency
- Lightweight: Single binary, no external dependencies
- Cross-platform: Linux, macOS, Unix variants (POSIX-compliant systems)
Requirements
- Go 1.21 or higher
- MCP-compatible client (Claude Desktop, Cursor, etc.)
Installation
# Clone the repository
git clone https://github.com/Agent-Hellboy/posix-system-mcp.git
cd posix-system-mcp
# Configure system (checks Go installation)
./configure
# Install for Claude Desktop
make install claude
# Install for Cursor
make install cursor
# Or install for both
make install claude cursor
Available Tools
Usage Examples
# Get system overview
get_system_info
# Get CPU usage per core
get_cpu_info {"per_cpu": true}
# Get top 10 processes by CPU usage
get_process_info {"limit": 10, "sort_by": "cpu"}
# Get disk usage for root partition
get_disk_info {"path": "/"}
Development
./configure
make deps # Install dependencies
make build # Build binary
make test # Run tests
make run # Run server directly
Docker
# Build Docker image
make docker-build
# Run in Docker container
make docker-run
# Open shell in container
make docker-shell
License
MIT License - see LICENSE file for details.
Contributing
Pull requests are welcome! Please run make test before submitting.