Skip to main content

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

Project description

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.

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

iflow_mcp_mcp_sys_bridge-0.1.4.tar.gz (26.6 kB view details)

Uploaded Source

Built Distribution

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

iflow_mcp_mcp_sys_bridge-0.1.4-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_mcp_sys_bridge-0.1.4.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_mcp_sys_bridge-0.1.4.tar.gz
Algorithm Hash digest
SHA256 2cf9aa362d625087b00bc911dac22df5512391fbf0c74cb652595a136d089ffc
MD5 1f02871dabd7eede5ea1c5408c7aca21
BLAKE2b-256 92095cabcd38ced75ebb11b73e77eeb1d087c63b8bf9f4622c20dfb7bc0f1f39

See more details on using hashes here.

File details

Details for the file iflow_mcp_mcp_sys_bridge-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_mcp_sys_bridge-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 87e8de9cf1c7d0281d5b1e6a4973756abe4f8d5ad881958c5ae91997fd89e432
MD5 fdcb0d97f631cbfa7040c3506157e5f9
BLAKE2b-256 073e7181697f9f99f49f155f87693e24aed9ea8d057c3c995853353e841b92e5

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