Zwischenablage zum Supabase MCP Helper

Ein lokaler Agent, der die Zwischenablage des Systems überwacht, alle kopierten Bilder in den Supabase-Speicher hochlädt und dann die öffentliche (oder signierte) URL wieder in die Zwischenablage schreibt.

Merkmale

Zero-Click-Bildhosting: Kopieren Sie ein Bild und erhalten Sie sofort eine URL
Geringe Latenz: Unter 800 ms vom Kopieren zur URL
Plattformübergreifend: Funktioniert unter macOS, Windows und Linux
MCP-Integration: Zwischenablage-Bildupload als MCP-Endpunkt verfügbar machen
Autostart: Konfigurieren Sie die Ausführung beim Systemstart
Effiziente Erkennung: Hash-basierte Deduplizierung mit geringer CPU-Auslastung

Voraussetzungen

Node.js 18+
Supabase-Konto mit aktiviertem Speicher
Plattformspezifische Abhängigkeiten:
- macOS: pngpaste ( brew install pngpaste )
- Windows/Linux: Nativer Zugriff auf die Zwischenablage des Betriebssystems

Installation

Klonen Sie das Repository:

git clone https://github.com/martinbowling/clipboard-to-supabase-mcp-helper.git cd clipboard-to-supabase-mcp-helper

Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie eine .env Datei basierend auf .env.example :

SUPABASE_URL=https://<project>.supabase.co SUPABASE_SERVICE_ROLE_KEY=your-service-role-key BUCKET=media MCP_PORT=3333

Testen Sie Ihre Supabase-Verbindung:

npm run test:supabase

Erstellen Sie das Projekt:

npm run build

Als Systemdienst installieren:

Für macOS:

npm run install:macos

Für Linux:

npm run install:linux

Für Windows:

npm run install:windows

Verwendung

Sobald der Helfer installiert und ausgeführt wird, führt er Folgendes aus:

Überwachen Sie Ihre Zwischenablage auf Bildänderungen (Abfrage alle 300 ms)
Laden Sie alle kopierten Bilder in Ihren Supabase-Bucket hoch
Legen Sie die öffentliche URL wieder in Ihre Zwischenablage, bereit zum Einfügen

Ausführen des Dienstes

Der Zwischenablage-Helfer kann in zwei Modi ausgeführt werden:

Stdio-Modus (Standard)

npm start

Dadurch wird der MCP-Server mit StdioServerTransport ausgeführt, ideal für die Verwendung über die Befehlszeile.

HTTP-Modus

npm run start:http

Dies führt einen Express-HTTP-Server auf Port 3333 (konfigurierbar) mit einem geeigneten REST-API-Endpunkt aus.

MCP-Integration

Der Helfer stellt die folgenden MCP-Endpunkte bereit:

Zwischenablagebild hochladen

Im HTTP-Servermodus:

POST http://localhost:3333/mcp

Anforderungstext:

{ "id": "1", "jsonrpc": "2.0", "method": "tool", "params": { "name": "upload_clipboard_image", "input": {} } }

Antwort:

{ "id": "1", "jsonrpc": "2.0", "result": { "content": [ { "type": "text", "text": "https://your-project.supabase.co/storage/v1/object/public/media/clips/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.png" } ] } }

Alte Dateien bereinigen

Der Helfer bietet auch einen MCP-Endpunkt, um die Bereinigung alter Dateien manuell auszulösen.

Anforderungstext:

{ "id": "1", "jsonrpc": "2.0", "method": "tool", "params": { "name": "cleanup_old_files", "input": { "days": 30 } } }

Antwort:

{ "id": "1", "jsonrpc": "2.0", "result": { "content": [ { "type": "text", "text": "Cleanup completed: Deleted 5 files older than 30 days. Failed: 0." } ] } }

Der Parameter days ist optional. Wenn er nicht angegeben wird, wird der Wert aus der Umgebungsvariable RETENTION_DAYS verwendet.

Wie es funktioniert

Änderungserkennung : Fragt alle 300 ms die Zwischenablage ab und berechnet den SHA-1-Hash der Bilddaten
Deduplizierung : Verarbeitet nur neue oder geänderte Bilder basierend auf einem Hash-Vergleich
Plattformanpassung : Verwendet plattformspezifische Methoden zum Erfassen von Zwischenablagebildern
Supabase-Integration : Lädt Bilder mit eindeutigen UUIDs in Ihren Supabase-Bucket hoch
MCP-Endpunkt : Stellt KI-Agenten die Funktionalität über das Model Context Protocol zur Verfügung
Automatische Bereinigung : Entfernt regelmäßig Bilder, die älter sind als die konfigurierte Aufbewahrungsfrist (Standard: 30 Tage).

Plattformspezifische Hinweise

macOS

Erfordert pngpaste : Installieren Sie mit brew install pngpaste
Verwendet LaunchAgents für den Autostart

Windows

Verwendet PowerShells System.Windows.Forms.Clipboard zur Bilderfassung
Verwendet die Windows-Registrierung für den Autostart

Linux

Verwendet xclip (X11) oder wl-paste (Wayland) für den Zugriff auf die Zwischenablage
Verwendet systemd für den Autostart

Entwicklung

# Run with live reload (stdio mode) npm run dev # Run with live reload (HTTP mode) npm run dev:http # Build for production npm run build # Run stdio version npm start # Run HTTP version npm run start:http

Lizenz

MIT

Deploy Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Tools

Related MCP Servers

Supabase MCP Server
Sentry01
-
security
F
license
-
quality
A bridge between AI assistants like GitHub Copilot and Supabase databases, allowing AI to understand schema, assist with query writing, and provide context-aware suggestions related to your data model.
Last updated -
MCP Vector Sync
-
security
-
license
-
quality
A multi-tenant service that automatically monitors Supabase database changes, generates OpenAI embeddings, and maintains synchronized vector search capabilities for each tenant's projects.
TalkHub Store MCP Server
-
security
-
license
-
quality
A Model Context Protocol server that integrates with Supabase, allowing AI assistants to access and manipulate store data through tools for product searching, filtering, and analysis.
MCP Clipboard Server
standardbeagle
-
security
A
license
-
quality
A high-performance server that provides clipboard access for AI assistants, specifically designed to solve the VSCode + WSL2 image clipboard limitation when using Claude.
Last updated -
3
4
MIT License

View all related MCP servers

Clipboard to Supabase MCP Helper