clipboard-mcp 도구란 무엇인가요?

읽기를 위한 get_clipboard, 쓰기를 위한 set_clipboard, 타임아웃으로 클립보드 모니터링을 위한 watch_clipboard.

Claude Desktop에 어떻게 연결하나요?

claude_desktop_config.json에 추가: mcpServers.clipboard.command = 'clipboard-mcp'.

Linux Wayland이 지원되나요?

네, wl-data-control을 통해; 데이터 지속성을 위해 클립보드 관리자 필요.

AI 클립보드용 MCP 서버

clipboard-mcp — AI 클립보드 액세스를 위한 Rust MCP 서버. 세 가지 도구: get/set/watch. 워크플로우 단계 감소, Windows/macOS/Linux 지원. 코드 리뷰 및 데이터 변환에 이상적.

By Sudonull Editorial Team • Published 2026-04-14 • Updated 2026-04-14

MCP를 통한 클립보드 AI 통합: clipboard-mcp 서버

Claude Desktop 및 Claude Code와 같은 AI 보조 도구는 시스템 클립보드에 직접 접근할 수 없습니다. 이로 인해 작업 흐름에서 불필요한 단계가 발생합니다: 오류를 복사하고 채팅창에 붙여넣기, 수정안을 받은 후 다시 복사하는 과정이 필요합니다. 루스트로 제작된 clipboard-mcp 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 클립보드 읽기, 쓰기, 모니터링 기능을 제공함으로써 이 문제를 해결합니다.

핵심 서버 도구

clipboard-mcp는 다음 도구를 포함하는 MCP 서버를 구현합니다:

get_clipboard: 클립보드 내용을 직접 가져옵니다. AI가 채팅창에 수동으로 붙여넣지 않고도 데이터를 바로 받을 수 있습니다.
set_clipboard: 출력 결과를 클립보드에 다시 씁니다. 에디터나 터미널에서 바로 Ctrl+V로 사용 가능합니다.
watch_clipboard: 폴링 방식으로 클립보드 변경 사항을 감시합니다. 기본 타임아웃은 30초, 최대 5분까지 설정 가능합니다.

런타임 의존성이 없고 약 250줄의 바이너리입니다. Windows, macOS(인텔/애플 실리콘), Linux(X11/Wayland) 모두 지원합니다.

cargo install clipboard-mcp로 설치하거나 사전 빌드된 릴리스를 사용하세요. Claude Desktop은 claude_desktop_config.json에 다음을 추가하여 연결합니다:

{
  "mcpServers": {
    "clipboard": {
      "command": "clipboard-mcp"
    }
  }
}

Claude Code 사용 시에는 claude mcp add clipboard clipboard-mcp 명령어를 입력하세요.

실용적인 활용 사례

양방향 처리 (Round-trip Processing)

복사 → 처리 → 결과가 클립보드에 바로 준비되는 두 단계만으로 완료됩니다:

오류 로그 → "이것을 고쳐줘" → 붙여넣기 준비 완료.
텍스트 → "독일어로 번역해줘" → 번역 결과가 클립보드에.
JSON → "형식 맞춰줘" → 정제된 구조화된 출력 결과.

데이터 변환

엑셀에서 추출한 CSV → "JSON으로 변환해줘" → 삽입 가능한 형식의 JSON 준비 완료. YAML↔JSON, 마크다운→HTML, XML 변환 등에 매우 유용합니다.

클립보드 모니터링

"60초 동안 감시하며, 매번 Ctrl+C 시 코드 분석". 창 전환 없이도 AI가 즉각 반응합니다.

코드 리뷰

GitHub 스니펫 → Ctrl+C → "버그 확인해줘". 원본 형식 유지, 채팅창에 붙여넣을 필요 없음.

클립보드 기록을 통한 스트리밍

에이전트가 각 단계에서 set_clipboard를 호출합니다. 클립보드 관리자(예: KDE 또는 GNOME)를 사용하면 중간 결과의 실시간 스트림을 확인할 수 있습니다.

기술적 구현

rmcp(Rust용 MCP SDK), arboard(크로스플랫폼 클립보드 라이브러리), tokio(단일 스레드 런타임) 기반으로 구축되었습니다.

클립보드 작업은 spawn_blocking 내에서 실행되어 MCP 서버가 차단되지 않도록 합니다. JSON-RPC를 stdio를 통해 전달합니다.

Linux 특성 주의사항: 클립보드 동작은 클립보드 매니저에 따라 다릅니다. 매니저가 없으면 소유자가 종료되면 데이터가 사라질 수 있습니다. KDE, GNOME, Sway+clipman과 자동 통합됩니다.

| 플랫폼 | 아키텍처 | 상태 |

|----------|--------------|--------|

| Windows | x86_64 | Windows 11 |

| macOS | x86_64, aarch64 | macOS 26.4 (Apple Silicon) |

| Linux | x86_64, aarch64 | X11 + Wayland (wl-data-control) |

CI는 모든 대상 플랫폼을 빌드합니다.

보안 및 제한 사항

AI가 클립보드에 완전히 접근합니다:

get_clipboard는 비밀번호 및 민감 정보 포함 모든 데이터를 반환합니다.
set_clipboard는 확인 없이 덮어씁니다(1MB 제한).
watch_clipboard는 이후 모든 Ctrl+C를 포착합니다.

신뢰할 수 있는 세션에서만 사용하세요. 오픈소스(MIT 라이선스), 검토 용이한 약 250줄의 코드로 구성되어 있습니다.

핵심 요약

복사된 내용 처리 시 작업 단계를 7단계에서 2단계로 줄였습니다.
런타임 의존성이 없는 크로스플랫폼 MCP 서버 — 단순한 약 250줄의 루스트 코드.
클립보드 읽기/쓰기/모니터링 도구 제공, Claude Desktop 및 Code와 통합 가능.
모든 데스크톱 환경(웨이랜드 포함)에서 작동하며, 보안은 사용자 책임입니다.

— Editorial Team

AI 클립보드용 MCP 서버