clipboard-mcp: даём AI-ассистентам доступ к буферу обмена

AI-ассистенты в 2026 году умеют писать код, анализировать данные и управлять инфраструктурой. Но попросите Claude прочитать то, что вы только что скопировали — и он не сможет этого сделать.

Буфер обмена — одна из самых базовых частей рабочего процесса на компьютере, но AI-ассистенты к нему не имеют доступа. Чтобы это исправить, я создал clipboard-mcp.

Обычно AI-клиенты вроде Claude Desktop или Claude Code не могут напрямую взаимодействовать с системным буфером обмена без дополнительных инструментов.

Типичный сценарий занимает семь шагов:

  1. Скопировали ошибку из терминала (Ctrl+C)
  2. Переключились в чат с AI
  3. Вставили текст (Ctrl+V)
  4. AI написал исправление
  5. Выделили ответ, скопировали
  6. Переключились обратно в редактор
  7. Вставили исправление

С clipboard-mcp — достаточно двух:

  1. Скопировали ошибку
  2. Написали: «Исправь то, что в моём буфере, и положи результат обратно»

Готово. Ctrl+V — и исправление уже в редакторе.

Как работает clipboard-mcp

Это MCP-сервер на Rust с тремя основными инструментами:

  • get_clipboard — AI читает содержимое буфера напрямую. Не нужно вручную вставлять текст в чат.
  • set_clipboard — AI записывает результат прямо в буфер. Не нужно копировать ответ из диалога.
  • watch_clipboard — AI отслеживает изменения буфера в реальном времени. Интервал опроса короткий, таймаут настраивается: от 30 секунд до 5 минут.

Один бинарник, ~250 строк кода, без внешних зависимостей во время выполнения. Работает на Windows, macOS (Intel и Apple Silicon) и Linux (X11 и Wayland).

Сценарии использования

Round-trip: скопировал → обработал → вставил

Самый частый сценарий. Копируете любой текст — AI обрабатывает, результат сразу в буфере:

  • Скопировали ошибку из лога → «объясни и исправь» → фикс в буфере
  • Скопировали абзац → «переведи на немецкий» → перевод в буфере
  • Скопировали сырой JSON → «отформатируй» → красивый JSON в буфере

Никакой ручной вставки в чат. Никакого копирования из чата.

Data transform: CSV → JSON за секунду

Скопировали таблицу из Excel → «Конвертируй то, что в буфере, в JSON» → Ctrl+V в редактор. Работает с любыми форматами: YAML↔JSON, Markdown→HTML, XML→любой другой.

Watch: AI реагирует на копирование

«Следи за буфером 60 секунд. Когда скопирую код — найди в нём баги»

Запустили команду — и просто копируете фрагменты кода. AI мгновенно получает каждый и анализирует. Не нужно переключаться между окнами.

Code review из буфера

Читаете код на GitHub. Видите подозрительный участок — выделили, Ctrl+C, и говорите: «Проверь код в моём буфере на ошибки». AI читает напрямую, не нужно вставлять текст в чат и рисковать потерять форматирование.

Streaming output через историю буфера

Любимый сценарий автора. Агент выполняет многошаговую задачу и после каждого шага вызывает set_clipboard с результатом. Если у вас есть менеджер буфера — вы видите хронологическую ленту всех промежуточных результатов.

По сути — потоковый вывод без специального интерфейса. Просто открываете историю буфера и просматриваете шаги.

Установка за 10 секунд

Два варианта:

  • Через cargo: cargo install clipboard-mcp
  • Скачать готовый бинарник с GitHub Releases

Подключение к Claude Desktop

Добавьте конфигурацию в claude_desktop_config.json.

Подключение к Claude Code

Готово. Теперь AI умеет работать с вашим буфером обмена.

Как это работает внутри

Model Context Protocol (MCP) — открытый стандарт от Anthropic. AI-клиент запускает MCP-сервер как отдельный процесс и общается с ним через JSON-RPC по stdio. Сервер объявляет доступные инструменты — клиент вызывает их по мере необходимости.

clipboard-mcp использует:

  • rmcp — официальный Rust SDK для MCP
  • arboard — библиотека для работы с буфером от 1Password
  • tokio — асинхронный runtime (однопоточный, current_thread)

Все операции с буфером выполняются в отдельных потоках через spawn_blocking, чтобы медленные вызовы (например, к X11 или Wayland) не блокировали сервер.

Нюанс для Linux

На macOS и Windows данные в буфере хранит операционная система. На Linux — приложение владеет содержимым буфера, и при завершении данные исчезают.

clipboard-mcp учитывает это: поведение зависит от окружения. Если установлен менеджер буфера (например, в KDE, GNOME или Sway + clipman), данные сохраняются. Без него — могут исчезнуть после закрытия приложения.

Архитектура поддерживает x86_64 и aarch64. Протестировано на Windows 11, macOS 14 (Apple Silicon) и Linux (X11 + Wayland через wl-data-control). CI автоматически собирает бинарники для всех платформ при каждом релизе.

Безопасность

clipboard-mcp даёт AI-клиенту полный доступ к буферу: чтение, запись, отслеживание. Это важно понимать:

  • get_clipboard возвращает всё, что сейчас в буфере — включая пароли, если они там есть
  • set_clipboard перезаписывает буфер без подтверждения (ограничение: 1 МБ)
  • watch_clipboard отправляет следующее, что вы скопируете

Подключайте только к тем AI-сессиям, которым доверяете. Код полностью открыт — всего около 250 строк, которые можно прочитать за 5 минут.

Что дальше

Планируется поддержка удалённого буфера через HTTP-транспорт вместо stdio. Сейчас сервер работает только локально. В следующей версии агент на удалённом сервере сможет читать и писать в буфер вашего компьютера. Это закроет главный разрыв между headless AI и пользователем.

  • GitHub: mnardit/clipboard-mcp
  • crates.io: clipboard-mcp
  • Сайт: max.nardit.com/clipboard-mcp
  • Лицензия: MIT

Если вы используете Claude Desktop, Claude Code или Cursor — попробуйте. Одна команда установки и одна строка в конфиге. Баг-репорты и PR приветствуются.

Читать оригинал