Metadata-Version: 2.4
Name: sys-mcp
Version: 0.2.1
Summary: A lightweight MCP server exposing basic system commands for UNIX-like environments.
Author-email: Antriksh Misri <antrikshmisri@gmail.com>
Maintainer-email: Antriksh Misri <antrikshmisri@gmail.com>
Keywords: automation,claude,cli,mcp,server,system,unix
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.18.0
Requires-Dist: pyyaml>=6.0.3
Description-Content-Type: text/markdown

# sys-mcp

A small MCP server that exposes basic system commands for UNIX-like environments. Works with Claude Desktop or any MCP-compatible client.

## Requirements

* Python 3.11 or newer
* [uv](https://docs.astral.sh/uv/) for dependency management
* UNIX-like system (macOS, Linux, BSD)

## Usage

```bash
uv run python -m src
```

Or add it to your MCP config:

```json
{
  "mcpServers": {
    "sys-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/sys-mcp",
        "run",
        "python",
        "-m",
        "src"
      ]
    }
  }
}
```

## Notes

* Runs over stdio, no network required
* Logs to stdout
* Blocks unsafe commands by default

You can test it with Claude Desktop by following [these steps](https://modelcontextprotocol.io/docs/develop/build-server#testing-your-server-with-claude-for-desktop).
