Clipboard Supabase MCP Helper

Monitors clipboard images, uploads to Supabase Storage, and exposes an MCP endpoint to return image URLs.

typescript

2

GitHub Stars

typescript

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

You can run a local MCP server that monitors your clipboard, uploads copied images to Supabase Storage, and exposes an MCP endpoint to trigger the upload from AI agents or other tools. This lets you share clipboard images securely and quickly via a generated URL, while keeping everything self-contained on your machine.

How to use

Install and run the server, then connect an MCP client to interact with the two supported modes. In Stdio mode you work directly from the command line and use the built-in MCP transport. In HTTP mode you run a small Express server that exposes a REST-style endpoint and a formal MCP interface. When you copy an image, the server uploads it to your configured Supabase bucket and places the resulting URL back into your clipboard for easy pasting.

From your MCP client you can invoke these two primary capabilities: upload the current clipboard image to your bucket and request cleanup of old files. The server is designed to start automatically and to detect clipboard changes efficiently so you can rely on near-instant hosting of images with minimal CPU usage.

How to install

Prerequisites you need before installing the MCP server.

Install dependencies and prepare the project on your system.

Clone the project, install dependencies, and build.

Configure environment variables, then test the Supabase connection and start the service in your preferred mode.

Platform notes

The server supports macOS, Windows, and Linux. Platform-specific prerequisites and startup methods are provided to ensure smooth operation across environments.

Configuration and startup commands

Two startup modes are available. Use one that fits your workflow.

Stdio mode uses the MCP Server transport suitable for command-line usage.

HTTP mode runs an Express server with a REST-like MCP endpoint exposed on port 3333 by default.

Available tools

upload_clipboard_image

Uploads the current clipboard image to the configured Supabase bucket and returns the public URL or a signed URL depending on setup.

cleanup_old_files

Removes images older than a specified retention period from the storage bucket.