mcp-sys-bridge

mcp-sys-bridge is a MCP (Model Context Protocol) server written in Python that exposes native operating system features through a lightweight bridge. It provides tools to open URLs in the default browser, copy text to the clipboard, send native OS notifications, and retrieve rich date information. This makes it possible for MCP clients to interact with the host system in a safe, cross-platform way. After starting the server via uvx mcp-sys-bridge, clients can invoke the available tools such as open_urls, copy_to_clipboard, send_notification, and get_current_date_info to perform common OS tasks without direct shell access.

Prerequisites:

• A supported runtime environment with uv installed (UV (uv) software): https://docs.astral.sh/uv/getting-started/installation
• Access to Python environments if you plan to run additional Python-based tooling alongside, though mcp-sys-bridge runs via uvx without requiring package installation.

Install and run:

1. Ensure uv is installed following the uv documentation.
2. Install or verify uvx is usable (no additional package installation required for this bridge).
3. Add the server to your MCP configuration as shown in the example below (in your MCP config file):

{
  "mcpServers": {
    "mcp-sys-bridge": {
      "command": "uvx",
      "args": ["mcp-sys-bridge"]
    }
  }
}

4. Start the MCP environment and connect a client to the mcp-sys-bridge server channel.

Notes:

• The bridge relies on uvx to load the MCP bridge for system interactions; no Python package installation is required for the bridge itself beyond what uvx handles.
• If you need to customize environment variables, you can augment the mcpServers[mcp-sys-bridge].env map in your MCP config.

Tips and notes:

• Tools exposed: open_urls (open a list of URLs in the default browser), copy_to_clipboard (copy text to clipboard), send_notification (show a native OS notification with title, message, app name, and timeout), and get_current_date_info (return detailed date/time information).
• Ensure proper permissions for clipboard access and notifications on your OS; some environments may require additional permissions or permissions prompts.
• If you update or change the MCP client configuration, restart the MCP environment to ensure the bridge is reloaded with the latest settings.
• The bridge aims to be cross-platform; behavior may vary slightly between Windows, macOS, and Linux, particularly for notifications and clipboard handling.