https://github.com/leynier/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.
https://github.com/leynier/mcp-sys-bridge
automation clipboard cross-platform developer-tools library mcp mcp-server model-context-protocol protocol python system-bridge system-integration toolkit url-opener utils
Last synced: 20 days ago
JSON representation
An implementation of the Model Context Protocol (MCP), acting as a simple bridge to native OS functionalities like clipboard management and URL handling.
- Host: GitHub
- URL: https://github.com/leynier/mcp-sys-bridge
- Owner: leynier
- License: mit
- Created: 2025-06-07T02:01:37.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-08T05:07:37.000Z (4 months ago)
- Last Synced: 2025-07-22T00:56:56.644Z (3 months ago)
- Topics: automation, clipboard, cross-platform, developer-tools, library, mcp, mcp-server, model-context-protocol, protocol, python, system-bridge, system-integration, toolkit, url-opener, utils
- Language: Python
- Homepage: https://pypi.org/project/mcp-sys-bridge
- Size: 61.5 KB
- Stars: 8
- Watchers: 0
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# MCP System Bridge
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/mcp-sys-bridge)
[](https://github.com/leynier/mcp-sys-bridge/commits)
[](https://github.com/leynier/mcp-sys-bridge/commits)
[](https://github.com/leynier/mcp-sys-bridge/stargazers)
[](https://github.com/leynier/mcp-sys-bridge/network/members)
[](https://github.com/leynier/mcp-sys-bridge)
[](https://github.com/leynier/mcp-sys-bridge/graphs/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](#overview)
* [Key Features](#key-features)
* [Installation](#installation)
* [Quick Start](#quick-start)
* [Available Tools](#available-tools)
* [Changelog](#changelog)
* [License](#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.
* 📆 **Date Info** — retrieve detailed information about the current date and time.
---
## Installation
`mcp-sys-bridge` runs directly with [uvx](https://docs.astral.sh/uv/getting-started/installation);
no package installation is required. Add the server to your MCP configuration:
```json
{
"mcpServers": {
"mcp-sys-bridge": {
"command": "uvx",
"args": ["mcp-sys-bridge"]
}
}
}
```
Ensure `uv` is installed following the [uv documentation](https://docs.astral.sh/uv/getting-started/installation).
---
## Quick Start
Start the bridge manually:
```bash
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`](license).