-
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 -
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
.envbasado 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 conbrew install pngpasteUtiliza 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)
local-only server
The server can only run on the client's local machine because it depends on local resources.
Un agente local que monitorea el portapapeles de su sistema, carga automáticamente las imágenes copiadas en Supabase Storage y reemplaza el contenido del portapapeles con la URL pública para compartir de inmediato.
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