Skip to content

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

License

Notifications You must be signed in to change notification settings

leynier/mcp-sys-bridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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

Topics

Resources

License

Stars

Watchers

Forks