MCP System Bridge

A bridge implementation of the Model Context Protocol (MCP) that exposes native operating system features such as clipboard management, URL handling and date information retrieval.

---

Table of Contents

• Overview
• Key Features
• Installation
• Quick Start
• Available Tools
• Changelog
• License

---

Overview

mcp-sys-bridge provides a minimal set of tools for MCP compatible clients, allowing them to interact with the underlying OS in a safe manner.

---

Key Features

• 🚀 URL Opening — open one or multiple URLs in the default browser.
• 📋 Clipboard Support — copy text directly to the clipboard.
• 🔔 System Notifications — send native OS notifications (Windows, macOS, Linux).
• 📆 Date Info — retrieve detailed information about the current date and time.

---

Installation

mcp-sys-bridge runs directly with uvx; no package installation is required. Add the server to your MCP configuration:

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

Ensure uv is installed following the uv documentation.

---

Quick Start

Start the bridge manually:

uvx mcp-sys-bridge

---

Available Tools

• open_urls — open a list of URLs in the default browser.
• copy_to_clipboard — copy text to the clipboard.
• send_notification — send a native system notification with customizable title, message, app name, and timeout.
• get_current_date_info — return rich information about the current date such as day number, week number, quarter and more.

---

Changelog

0.1.5

• Added send_notification tool to send native system notifications across Windows, macOS, and Linux.
• Added plyer dependency for cross-platform notification support.

0.1.4

• Defined annotations to declare tools as read-only.

0.1.3

• Added get_current_date_info tool to get comprehensive information about the current date.

0.1.2

• Change open_url to open_urls to open a list of URLs in the default browser.

0.1.1

• Improve the open_url tool to handle URLs without a scheme and validate that the URL is valid.

0.1.0

• Added open_url tool.
• Added copy_to_clipboard tool.

---

License

MIT License. See license.