Skip to main content

A lightweight MCP server exposing basic system commands for UNIX-like environments.

Project description

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 for dependency management
  • UNIX-like system (macOS, Linux, BSD)

Usage

uv run python -m src

Or add it to your MCP config:

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sys_mcp-0.2.1.tar.gz (141.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sys_mcp-0.2.1-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file sys_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: sys_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 141.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.8

File hashes

Hashes for sys_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 1f11012a21c20bf47af0f956d1bc8251723f8bb63fb1fb660291d8bf3eb01864
MD5 fce1ab4cd8276350371ae0f6a0280b92
BLAKE2b-256 77a4cc1061d39640a9023aab8848cd39285f90330845a17fe0bc059f5aee592d

See more details on using hashes here.

File details

Details for the file sys_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: sys_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.8

File hashes

Hashes for sys_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 585633e25f89d94ccc09dd1a727be1931d960f79825de5481c68fe06576f30fd
MD5 168ae95dceec92c16da7626cae4b9a92
BLAKE2b-256 882c8b8d711bcd5e03cbe4d0fde5ffa0e60de9e8a9bfc9d49bc832b1e8149fcf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page