-
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 -
Буфер обмена для Supabase MCP Helper
Локальный агент, который отслеживает системный буфер обмена, загружает все скопированные изображения в хранилище Supabase, а затем записывает общедоступный (или подписанный) URL-адрес обратно в буфер обмена.
Функции
Хостинг изображений с нулевым кликом: скопируйте изображение и мгновенно получите URL-адрес
Низкая задержка: менее 800 мс от копирования до URL
Кроссплатформенность: работает на macOS, Windows и Linux
Интеграция MCP: предоставление возможности загрузки изображения в буфер обмена в качестве конечной точки MCP
Автозапуск: настроить запуск при запуске системы
Эффективное обнаружение: дедупликация на основе хэширования с низкой загрузкой ЦП
Предпосылки
Node.js 18+
Учетная запись Supabase с включенным хранилищем
Зависимости, специфичные для платформы:
macOS:
pngpaste(brew install pngpaste)Windows/Linux: доступ к буферу обмена собственной ОС
Установка
Клонируйте репозиторий:
git clone https://github.com/martinbowling/clipboard-to-supabase-mcp-helper.git
cd clipboard-to-supabase-mcp-helper
Установить зависимости:
npm install
Создайте файл
.envна основе.env.example:
SUPABASE_URL=https://<project>.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
BUCKET=media
MCP_PORT=3333
Проверьте подключение Supabase:
npm run test:supabase
Создайте проект:
npm run build
Установить как системную службу:
Для macOS:
npm run install:macos
Для Linux:
npm run install:linux
Для Windows:
npm run install:windows
Использование
После установки и запуска помощник будет:
Отслеживайте изменения изображений в буфере обмена (опрос каждые 300 мс)
Загрузите все скопированные изображения в ваш контейнер Supabase.
Поместите общедоступный URL-адрес обратно в буфер обмена, готовый к вставке.
Запуск службы
Помощник буфера обмена может работать в двух режимах:
Режим Stdio (по умолчанию)
npm start
Это запускает сервер MCP с StdioServerTransport, что идеально подходит для использования в командной строке.
HTTP-режим
npm run start:http
Он запускает HTTP-сервер Express на порту 3333 (настраивается) с соответствующей конечной точкой REST API.
Интеграция МКП
Помощник предоставляет следующие конечные точки MCP:
Загрузить изображение буфера обмена
В режиме HTTP-сервера:
POST http://localhost:3333/mcp
Текст запроса:
{
"id": "1",
"jsonrpc": "2.0",
"method": "tool",
"params": {
"name": "upload_clipboard_image",
"input": {}
}
}
Ответ:
{
"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"
}
]
}
}
Очистка старых файлов
Помощник также предоставляет конечную точку MCP для ручного запуска очистки старых файлов.
Текст запроса:
{
"id": "1",
"jsonrpc": "2.0",
"method": "tool",
"params": {
"name": "cleanup_old_files",
"input": {
"days": 30
}
}
}
Ответ:
{
"id": "1",
"jsonrpc": "2.0",
"result": {
"content": [
{
"type": "text",
"text": "Cleanup completed: Deleted 5 files older than 30 days. Failed: 0."
}
]
}
}
Параметр days является необязательным. Если он не указан, будет использовано значение из переменной среды RETENTION_DAYS .
Как это работает
Обнаружение изменений : опрашивает буфер обмена каждые 300 мс и вычисляет хэш SHA-1 данных изображения.
Дедупликация : обрабатывает только новые или измененные изображения на основе сравнения хэшей.
Адаптация платформы : использует специфичные для платформы методы для захвата изображений буфера обмена.
Интеграция с Supabase : загружает изображения в ваш контейнер Supabase с уникальными UUID.
Конечная точка MCP : предоставляет функциональность агентам ИИ через протокол контекста модели
Автоматическая очистка : периодически удаляет изображения старше установленного срока хранения (по умолчанию: 30 дней)
Заметки, специфичные для платформы
macOS
Требуется
pngpaste: Установить с помощьюbrew install pngpasteИспользует LaunchAgents для автозапуска
Окна
Использует PowerShell System.Windows.Forms.Clipboard для захвата изображений
Использует реестр Windows для автозапуска
Линукс
Использует xclip (X11) или wl-paste (Wayland) для доступа к буферу обмена
Использует systemd для автозапуска
Разработка
# 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
Лицензия
Массачусетский технологический институт
local-only server
The server can only run on the client's local machine because it depends on local resources.
Локальный агент, который отслеживает буфер обмена вашей системы, автоматически загружает скопированные изображения в хранилище Supabase и заменяет содержимое буфера обмена общедоступным URL-адресом для немедленного обмена.
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