# Posix System Mcp

> 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.

- **Type:** MCP server
- **Install:** `agentstack add mcp-agent-hellboy-posix-system-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Agent-Hellboy](https://agentstack.voostack.com/s/agent-hellboy)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Agent-Hellboy](https://github.com/Agent-Hellboy)
- **Source:** https://github.com/Agent-Hellboy/posix-system-mcp

## Install

```sh
agentstack add mcp-agent-hellboy-posix-system-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
# 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

```bash
./configure
make deps      # Install dependencies
make build     # Build binary
make test      # Run tests
make run       # Run server directly
```

## Docker

```bash
# 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](https://github.com/Agent-Hellboy)
- **Source:** [Agent-Hellboy/posix-system-mcp](https://github.com/Agent-Hellboy/posix-system-mcp)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-agent-hellboy-posix-system-mcp
- Seller: https://agentstack.voostack.com/s/agent-hellboy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
