clipboard-mcp

clipboard-mcp

Servidor multiplataforma de Model Context Protocol (MCP) que brinda a los asistentes de IA acceso directo de lectura/escritura al portapapeles de tu sistema. Sitio web

Copia un error → pídele a Claude que lo corrija → la corrección llega a tu portapapeles. Sin pegado manual en el chat, sin copiado manual de la respuesta.

cargo install clipboard-mcp

¿Por qué clipboard-mcp?

• Binario único — sin Python, sin Node.js, sin tiempo de ejecución que instalar
• Portapapeles nativo — usa arboard de 1Password, no comandos de shell como pbcopy/xclip
• Modo de vigilancia — watch_clipboard permite que los agentes reaccionen a lo que copias en tiempo real
• Detección de HTML y formatos — lee contenido HTML, explora los formatos de portapapeles disponibles
• Multiplataforma — Windows, macOS (Intel + Apple Silicon), Linux (X11 + Wayland)
• Transporte HTTP — ejecútalo como servidor HTTP local para acceso remoto de agentes

Herramientas

Herramienta	Descripción
get_clipboard	Lee el texto actual del portapapeles. El contenido de más de 100 KB se trunca.
get_clipboard_html	Lee contenido HTML del portapapeles (p. ej., texto enriquecido de navegadores).
set_clipboard	Escribe texto en el portapapeles (máx. 1 MB).
watch_clipboard	Espera a que el texto del portapapeles cambie (predeterminado 30 s, máx. 300 s). Máx. 5 concurrentes.
list_clipboard_formats	Explora qué formatos están disponibles (texto, HTML, imagen, archivos).
clear_clipboard	Borra todo el contenido del portapapeles.

Parámetros de watch_clipboard

Parámetro	Tipo	Predeterminado	Descripción
timeout_secs	entero (opcional)	30	Segundos para esperar un cambio (máx. 300)

Instalación

cargo install clipboard-mcp

O descarga un binario desde GitHub Releases.

Configuración

Claude Desktop (stdio, predeterminado)

Agrega a 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

Ejecútalo como servidor HTTP para acceso remoto o 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)

Punto final MCP: http://HOST:PORT/mcp

Ejemplos de uso

Leer y transformar:

"Toma lo que esté en mi portapapeles y reescríbelo en un tono más formal, luego coloca el resultado de vuelta."

Vigilar cambios:

"Vigila mi portapapeles durante 60 segundos. Cuando copie algo, resúmelo en una oración."

Ida y vuelta:

"Obtén mi portapapeles, tradúcelo al alemán y coloca la traducción de vuelta."

Transformación de datos:

Copia una tabla CSV → "Convierte lo que está en mi portapapeles a JSON" → pega el JSON formateado en tu editor.

Código desde el portapapeles:

Copia un fragmento de código desde un navegador → "Revisa el código en mi portapapeles en busca de errores" → Claude lo lee directamente, sin pegarlo en el chat.

Salida del agente paso a paso mediante el historial del portapapeles:

Ejecuta una tarea de varios pasos y set_clipboard después de cada paso. Con cualquier gestor de portapapeles (Paste, CopyQ, Klipper), obtienes un registro cronológico de cada resultado: navega, busca y revisa el trabajo del agente sin cambiar de ventana.

Soporte de plataformas

• Windows (x86_64) — el portapapeles persiste mediante el portapapeles del sistema operativo
• macOS (x86_64, aarch64) — el portapapeles persiste mediante el portapapeles del sistema operativo
• Linux (x86_64, aarch64) — X11 y Wayland (mediante el protocolo wl-data-control)

Nota para Linux: En Linux, el contenido del portapapeles establecido por el servidor se mantiene activo mediante un hilo en segundo plano. Si no se ejecuta un gestor de portapapeles (gestores de ventanas básicos como i3/dwm), instala clipman, parcellite o copyq.

Cómo funciona

Binario único. Usa arboard (de 1Password) para acceso nativo al portapapeles. Se comunica mediante el protocolo MCP sobre stdio (predeterminado) o HTTP (indicador --http, transporte HTTP Streamable). Sin dependencias de tiempo de ejecución en Windows y macOS; Linux requiere bibliotecas X11 o un compositor Wayland con soporte para wl-data-control.

Solución de problemas

Linux: el contenido del portapapeles desaparece Asegúrate de que un gestor de portapapeles esté en ejecución. En gestores de ventanas básicos (i3, dwm), instala clipman, parcellite o copyq.

Wayland: "el portapapeles está vacío o contiene contenido no textual" Tu compositor debe admitir el protocolo wl-data-control. Sway, Hyprland, GNOME y KDE lo admiten. Los compositores más antiguos pueden no hacerlo.

macOS: acceso al portapapeles denegado Asegúrate de que la terminal que ejecuta el servidor MCP tenga permisos de portapapeles en Configuración del sistema > Privacidad y seguridad.

Seguridad

Este servidor otorga a los clientes MCP conectados acceso completo de lectura/escritura a tu portapapeles del sistema:

• get_clipboard / get_clipboard_html — devuelven el contenido del portapapeles tal cual
• set_clipboard — sobrescribe silenciosamente el contenido del portapapeles (máx. 1 MB)
• watch_clipboard — devuelve lo siguiente que copies, tal cual
• clear_clipboard — borra el portapapeles sin confirmación

Solo conecta este servidor a sesiones de IA en las que confíes. No lo uses en entornos donde puedan haber datos sensibles (contraseñas, tokens) en el portapapeles.

Modo HTTP: El enlace predeterminado es 127.0.0.1 (solo localhost). Enlazar a 0.0.0.0 con --host expone el portapapeles a todas las interfaces de red alcanzables. Las solicitudes iniciadas por navegador (con el encabezado Origin) se rechazan con 403. No hay autenticación: los clientes HTTP que no son navegadores no están restringidos. Para acceso remoto, prefiere el túnel SSH sobre exponerlo a la red.

Contribuciones

Los informes de errores y las solicitudes de extracción son bienvenidos. Para cambios importantes, abre primero un problema.

Licencia

MIT