Posix System Mcp

POSIX System MCP Server

[](https://github.com/Agent-Hellboy/posix-system-mcp/actions/workflows/makefile.yml) [](https://codecov.io/gh/Agent-Hellboy/posix-system-mcp) [](https://goreportcard.com/report/github.com/Agent-Hellboy/posix-system-mcp) [](LICENSE)

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

| Tool | Description | |------|-------------| | get_system_info | System information (hostname, OS, uptime, etc.) | | get_cpu_info | CPU usage and details | | get_memory_info | Memory and swap usage | | get_disk_info | Disk usage by partition | | get_network_info | Network interface statistics | | get_process_info | Running process information | | get_load_average | System load averages |

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](LICENSE) file for details.

Contributing

Pull requests are welcome! Please run make test before submitting.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Agent-Hellboy
• Source: Agent-Hellboy/posix-system-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.