-
securityF
license-
qualityA 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 -
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
.envDatei 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 mitbrew install pngpasteVerwendet 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
local-only server
The server can only run on the client's local machine because it depends on local resources.
Ein lokaler Agent, der Ihre Systemzwischenablage überwacht, kopierte Bilder automatisch in den Supabase-Speicher hochlädt und den Inhalt der Zwischenablage durch die öffentliche URL zur sofortigen Freigabe ersetzt.
Related MCP Servers
- -securityFlicense-qualityA multi-tenant service that automatically monitors Supabase database changes, generates OpenAI embeddings, and maintains synchronized vector search capabilities for each tenant's projects.Last updated -
- -securityFlicense-qualityA 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.Last updated -
- -securityAlicense-qualityA 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 -23MIT License