Ayudante de portapapeles a Supabase MCP

Un agente local que monitorea el portapapeles del sistema, carga cualquier imagen copiada en Supabase Storage y luego escribe la URL pública (o firmada) nuevamente en el portapapeles.

Características

Alojamiento de imágenes sin clics: copie una imagen y obtenga una URL al instante
Baja latencia: menos de 800 ms desde la copia hasta la URL
Multiplataforma: funciona en macOS, Windows y Linux
Integración con MCP: Exponer la carga de imágenes del portapapeles como un punto final de MCP
Inicio automático: configurar para que se ejecute al iniciar el sistema
Detección eficiente: deduplicación basada en hash con bajo uso de CPU

Prerrequisitos

Node.js 18+
Cuenta de Supabase con almacenamiento habilitado
Dependencias específicas de la plataforma:
- macOS: pngpaste ( brew install pngpaste )
- Windows/Linux: Acceso al portapapeles del sistema operativo nativo

Instalación

Clonar el repositorio:

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

Instalar dependencias:

npm install

Cree un archivo .env basado en .env.example :

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

Pruebe su conexión Supabase:

npm run test:supabase

Construir el proyecto:

npm run build

Instalar como servicio del sistema:

Para macOS:

npm run install:macos

Para Linux:

npm run install:linux

Para Windows:

npm run install:windows

Uso

Una vez instalado y en ejecución, el ayudante hará lo siguiente:

Monitorea tu portapapeles para detectar cambios en las imágenes (sondeo cada 300 ms)
Sube cualquier imagen copiada a tu bucket de Supabase
Coloque la URL pública nuevamente en su portapapeles, lista para pegar

Ejecución del servicio

El asistente del portapapeles se puede ejecutar en dos modos:

Modo Stdio (predeterminado)

npm start

Esto ejecuta el servidor MCP con StdioServerTransport, ideal para el uso de la línea de comandos.

Modo HTTP

npm run start:http

Esto ejecuta un servidor HTTP Express en el puerto 3333 (configurable) con un punto final de API REST adecuado.

Integración MCP

El ayudante expone los siguientes puntos finales de MCP:

Subir imagen del portapapeles

Con modo de servidor HTTP:

POST http://localhost:3333/mcp

Cuerpo de la solicitud:

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

Respuesta:

{
  "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"
      }
    ]
  }
}

Limpiar archivos antiguos

El ayudante también proporciona un punto final MCP para activar manualmente la limpieza de archivos antiguos.

Cuerpo de la solicitud:

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

Respuesta:

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

El parámetro days es opcional. Si no se proporciona, se utilizará el valor de la variable de entorno RETENTION_DAYS .

Cómo funciona

Detección de cambios : sondea el portapapeles cada 300 ms y calcula el hash SHA-1 de los datos de la imagen
Desduplicación : solo procesa imágenes nuevas o modificadas según la comparación de hash
Adaptación de la plataforma : utiliza métodos específicos de la plataforma para capturar imágenes del portapapeles
Integración con Supabase : carga imágenes en su depósito de Supabase con UUID únicos
Punto final MCP : expone la funcionalidad a los agentes de IA a través del Protocolo de contexto de modelo
Limpieza automática : elimina periódicamente las imágenes más antiguas que el período de retención configurado (predeterminado: 30 días)

Notas específicas de la plataforma

macOS

Requiere pngpaste : instalar con brew install pngpaste
Utiliza LaunchAgents para el inicio automático

Ventanas

Utiliza System.Windows.Forms.Clipboard de PowerShell para la captura de imágenes
Utiliza el Registro de Windows para el inicio automático

Linux

Utiliza xclip (X11) o wl-paste (Wayland) para acceder al portapapeles
Utiliza systemd para el inicio automático

Desarrollo

# 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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Clipboard to Supabase MCP Helper

Integrations