Буфер обмена для 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
- Установить зависимости:
- Создайте файл
.env на основе .env.example :
SUPABASE_URL=https://<project>.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
BUCKET=media
MCP_PORT=3333
- Проверьте подключение Supabase:
- Создайте проект:
- Установить как системную службу:
Для macOS:
Для Linux:
Для Windows:
Использование
После установки и запуска помощник будет:
- Отслеживайте изменения изображений в буфере обмена (опрос каждые 300 мс)
- Загрузите все скопированные изображения в ваш контейнер Supabase.
- Поместите общедоступный URL-адрес обратно в буфер обмена, готовый к вставке.
Запуск службы
Помощник буфера обмена может работать в двух режимах:
Режим Stdio (по умолчанию)
Это запускает сервер MCP с StdioServerTransport, что идеально подходит для использования в командной строке.
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
Лицензия
Массачусетский технологический институт