clipboard-mcp

clipboard-mcp

Servidor Model Context Protocol (MCP) multiplataforma que dá aos assistentes de IA acesso direto de leitura/gravação à área de transferência do seu sistema. Website

Copie um erro → peça ao Claude para corrigi-lo → a correção vai para a sua área de transferência. Sem colar manualmente no chat, sem copiar manualmente da resposta.

cargo install clipboard-mcp

Por que clipboard-mcp?

• Binário único — sem Python, sem Node.js, sem runtime para instalar
• Área de transferência nativa — usa arboard da 1Password, não comandos de shell como pbcopy/xclip
• Modo de observação — watch_clipboard permite que agentes reajam ao que você copia em tempo real
• Detecção de HTML + formato — leia conteúdo HTML, verifique os formatos disponíveis na área de transferência
• Multiplataforma — Windows, macOS (Intel + Apple Silicon), Linux (X11 + Wayland)
• Transporte HTTP — execute como um servidor HTTP local para acesso remoto de agentes

Ferramentas

Ferramenta	Descrição
get_clipboard	Lê o texto atual da área de transferência. Conteúdo acima de 100 KB é truncado.
get_clipboard_html	Lê conteúdo HTML da área de transferência (ex.: texto rico de navegadores).
set_clipboard	Escreve texto na área de transferência (máx. 1 MB).
watch_clipboard	Aguarda o texto da área de transferência mudar (padrão 30s, máx. 300s). Máx. 5 simultâneos.
list_clipboard_formats	Verifica quais formatos estão disponíveis (texto, HTML, imagem, arquivos).
clear_clipboard	Limpa todo o conteúdo da área de transferência.

Parâmetros do watch_clipboard

Parâmetro	Tipo	Padrão	Descrição
timeout_secs	inteiro (opcional)	30	Segundos para aguardar uma mudança (máx. 300)

Instalação

cargo install clipboard-mcp

Ou baixe um binário das GitHub Releases.

Configuração

Claude Desktop (stdio, padrão)

Adicione em claude_desktop_config.json:

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

Claude Code (stdio)

# Add for current project
claude mcp add clipboard clipboard-mcp

# Or add globally
claude mcp add --scope user clipboard clipboard-mcp

Transporte HTTP

Execute como um servidor HTTP para acesso remoto ou programático:

clipboard-mcp --http                          # 127.0.0.1:3100
clipboard-mcp --http --port 8080              # custom port
clipboard-mcp --http --host 0.0.0.0           # expose to network (see Security)

Endpoint MCP: http://HOST:PORT/mcp

Exemplos de Uso

Ler e transformar:

"Pegue o que estiver na minha área de transferência e reescreva em um tom mais formal, depois coloque o resultado de volta."

Observar mudanças:

"Observe minha área de transferência por 60 segundos. Quando eu copiar algo, resuma em uma frase."

Ida e volta:

"Pegue minha área de transferência, traduza para o alemão e coloque a tradução de volta."

Transformação de dados:

Copie uma tabela CSV → "Converta o que está na minha área de transferência para JSON" → cole o JSON formatado no seu editor.

Código da área de transferência:

Copie um trecho de código de um navegador → "Revise o código na minha área de transferência em busca de bugs" → Claude lê diretamente, sem colar no chat.

Saída passo a passo do agente via histórico da área de transferência:

Execute uma tarefa de várias etapas e set_clipboard após cada etapa. Com qualquer gerenciador de área de transferência (Paste, CopyQ, Klipper), você obtém um registro cronológico de cada resultado — navegue, pesquise e revise o trabalho do agente sem trocar de janela.

Suporte de Plataformas

• Windows (x86_64) — a área de transferência persiste via pasteboard do SO
• macOS (x86_64, aarch64) — a área de transferência persiste via pasteboard do SO
• Linux (x86_64, aarch64) — X11 e Wayland (via protocolo wl-data-control)

Nota sobre Linux: No Linux, o conteúdo da área de transferência definido pelo servidor é mantido ativo por uma thread em segundo plano. Se nenhum gerenciador de área de transferência estiver em execução (WMs básicos como i3/dwm), instale clipman, parcellite ou copyq.

Como Funciona

Binário único. Usa arboard (da 1Password) para acesso nativo à área de transferência. Comunica-se via protocolo MCP sobre stdio (padrão) ou HTTP (flag --http, transporte HTTP Streamable). Sem dependências de runtime no Windows e macOS; Linux requer bibliotecas X11 ou um compositor Wayland com suporte a wl-data-control.

Solução de Problemas

Linux: o conteúdo da área de transferência desaparece Garanta que um gerenciador de área de transferência esteja em execução. Em gerenciadores de janela básicos (i3, dwm), instale clipman, parcellite ou copyq.

Wayland: "a área de transferência está vazia ou contém conteúdo não textual" Seu compositor deve suportar o protocolo wl-data-control. Sway, Hyprland, GNOME e KDE suportam. Compositors mais antigos podem não suportar.

macOS: acesso à área de transferência negado Garanta que o terminal que executa o servidor MCP tenha permissões de área de transferência em Ajustes do Sistema > Privacidade e Segurança.

Segurança

Este servidor dá aos clientes MCP conectados acesso total de leitura/gravação à área de transferência do seu sistema:

• get_clipboard / get_clipboard_html — retornam o conteúdo da área de transferência literalmente
• set_clipboard — sobrescreve silenciosamente o conteúdo da área de transferência (máx. 1 MB)
• watch_clipboard — retorna a próxima coisa que você copiar, literalmente
• clear_clipboard — limpa a área de transferência sem confirmação

Conecte este servidor apenas a sessões de IA em que você confia. Não o use em ambientes onde dados sensíveis (senhas, tokens) possam estar na área de transferência.

Modo HTTP: O bind padrão é 127.0.0.1 (somente localhost). Vincular a 0.0.0.0 com --host expõe a área de transferência a todas as interfaces de rede alcançáveis. Requisições iniciadas por navegador (com cabeçalho Origin) são rejeitadas com 403. Não há autenticação — clientes HTTP que não sejam navegadores não são restritos. Para acesso remoto, prefira túnel SSH a expor à rede.

Contribuindo

Relatórios de bugs e pull requests são bem-vindos. Para mudanças significativas, abra uma issue primeiro.

Licença

MIT