MCP Clipboard Server

High-performance MCP server for clipboard access with WSL2 support

go

4

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "standardbeagle-mcp-clip": {
      "command": "mcp-clip",
      "args": [],
      "env": {
        "MCP_DEBUG": "1",
        "MCP_CLEANUP_TTL": "2h"
      }
    }
  }
}

The MCP Clipboard Server provides fast, lock-free access to the Windows clipboard from WSL2 and other environments, enabling Claude and similar AI assistants to read and use clipboard content, including images. It automatically handles large content, detects formats, and notifies you in real time when the clipboard changes.

How to use

You connect to the MCP Clipboard Server from your MCP client (for example Claude Desktop or a code editor with the MCP extension) by pointing to the local clipboard server configuration. Once configured, you can read clipboard content on demand, including text and images, and access large content via temporary files when needed. Real-time notifications tell you when new clipboard content is available so your assistant can react immediately.

Key usage patterns:

Read current clipboard content with automatic format detection
Access images as files with proper extensions
Handle content larger than 25KB via temporary files
Receive real-time updates when the clipboard changes to minimize polling
Use the server from Claude Desktop or the VSCode/WSL2 setup to bridge Windows clipboard access into your environment.

Configure Claude Desktop to use the clipboard server by adding the MCP server configuration to claude_desktop_config.json. You will point the clipboard action to the mcp-clip command with no extra arguments. When Claude detects content, it will fetch it through the server according to the detected format.

How to install

Prerequisites: you need Node.js and Go installed if you plan to use the multiple installation methods described.

Install via NPM (recommended for quick start):

npm install -g @standardbeagle/mcp-clip

Install via Go (native binary):

go install github.com/standardbeagle/mcp-clip@latest

Manual installation (build from source and place in PATH):

git clone https://github.com/standardbeagle/mcp-clip.git
cd mcp-clip
go build -o mcp-clip
sudo cp mcp-clip /usr/local/bin/

Configuration and run

To run the clipboard server locally, you can execute the built binary. The server is designed to be started in your environment and then wired into your MCP clients via the configuration blocks below.

Configure your client to point to the local server:

Claude Desktop: add a clipboard MCP server entry pointing to the executable. Content will be read by the server and returned in supported formats.

Available tools

read_clipboard

Reads current clipboard content with automatic format detection, including images (PNG, JPEG, GIF, WebP, BMP) and binary data. Large content (>25KB) is saved to temp files and file paths are provided for access.