MCP ExplorerExplorer

Macos Cliboard Mcp

@xiaoquismeon a year ago
1 MIT
FreeCommunity
AI Systems
#clipboard#macos#mcp#mcp-server
A simple utility that provides model context protocol (MCP) tools for interacting with the macOS clipboard.

Overview

What is Macos Cliboard Mcp

macos-cliboard-mcp is a simple utility that provides tools for interacting with the macOS clipboard using the model context protocol (MCP).

Use cases

Use cases for macos-cliboard-mcp include automating clipboard operations in applications, enhancing productivity tools, and facilitating data transfer between applications.

How to use

To use macos-cliboard-mcp, start the MCP server with the command ‘mcp dev main.py’. You can then use the provided tools to copy text, paste text, or paste images from the clipboard.

Key features

Key features include copying text to the clipboard, pasting text from the clipboard, and pasting images from the clipboard in TIFF, PNG, and JPEG formats.

Where to use

macos-cliboard-mcp can be used in software development environments where clipboard interactions are necessary, particularly on macOS systems.

Content

MacOS Clipboard MCP

A simple utility that provides model context protocol (MCP) tools for interacting with the macOS clipboard.

Features

  • Copy text to the clipboard
  • Paste text from the clipboard
  • Paste images from the clipboard (supports TIFF, PNG, and JPEG formats)

mcp config

method1(recommended)

{
  "clipboard": {
    "command": "uvx",
    "args": [
      "macos-clipboard-mcp"
    ]
  }
}

method2

{
  "clipboard": {
    "command": "uv",
    "args": [
      "--directory",
      "<your-local-folder>/macos-clipboard-mcp",
      "run",
      "main.py"
    ]
  }
}

Installation

uv sync
python main.py

Requirements

  • Python 3.12+
  • macOS (uses AppleScript for clipboard operations)

Usage

Start the MCP server:

mcp dev main.py

This exposes the following MCP tools:

  • copy_to_clipboard(data: str): Copies text to the clipboard
  • paste_from_clipboard(): Returns text from the clipboard
  • paste_image_from_clipboard(): Returns images from the clipboard as base64-encoded PNG

Development

This project uses modern Python tooling:

  • uv for dependency management

License

MIT

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers