mcp-sys-bridge

An implementation of the Model Context Protocol (MCP), acting as a simple bridge to native OS functionalities like clipboard management and URL handling.

GitHub Stars

8

User Rating

Not Rated

Forks

1

Issues

1

Views

1

Favorites

0

README
MCP System Bridge

License: MIT Version Last commit Commit activity Stars Forks Watchers Contributors

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

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.
  • 📆 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.
  • get_current_date_info — return rich information about the current date such as day number, week number, quarter and more.

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

Author Information
Leynier Gutiérrez González

CTO at @educup • CS graduate at @matcom

@educup @lynot

270

Followers

145

Repositories

16

Gists

16

Total Contributions

Top Contributors

Threads