Clipboard Mcp

clipboard-mcp

跨平台的 Model Context Protocol（MCP）服务，可让 AI 助手直接读写系统剪贴板。网站

复制错误信息 → 让 Claude 修复 → 修复结果就会出现在剪贴板中。无需手动粘贴到聊天中，也无需手动从回复中复制。

cargo install clipboard-mcp

为什么选择 clipboard-mcp？

• 单个二进制文件 — 无需安装 Python、Node.js 或其他运行时
• 原生剪贴板 — 使用 1Password 的 arboard，而非 pbcopy/xclip 之类的 shell 命令
• 监视模式 — watch_clipboard 可让 Agent 实时响应你复制的内容
• HTML + 格式检测 — 读取 HTML 内容，探测可用的剪贴板格式
• 跨平台 — Windows、macOS（Intel + Apple Silicon）、Linux（X11 + Wayland）
• HTTP 传输 — 可作为本地 HTTP 服务运行，供远程 Agent 访问

工具

工具	描述
get_clipboard	读取剪贴板中的当前文本。超过 100 KB 的内容会被截断。
get_clipboard_html	读取剪贴板中的 HTML 内容（例如浏览器中的富文本）。
set_clipboard	将文本写入剪贴板（最大 1 MB）。
watch_clipboard	等待剪贴板文本发生变化（默认 30s，最长 300s）。最多支持 5 个并发任务。
list_clipboard_formats	探测可用的格式（文本、HTML、图像、文件）。
clear_clipboard	清除剪贴板中的所有内容。

watch_clipboard 参数

参数	类型	默认值	描述
timeout_secs	integer (optional)	30	等待变化的秒数（最长 300）

安装

cargo install clipboard-mcp

或者从 GitHub Releases 下载二进制文件。

配置

Claude Desktop（stdio，默认）

添加到 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

HTTP 传输

作为 HTTP 服务运行，以供远程或程序化访问：

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)

MCP 端点：http://HOST:PORT/mcp

使用示例

读取并转换：

“获取剪贴板中的内容，将其改写得更正式，然后把结果放回剪贴板。”

监视变化：

“监视我的剪贴板 60 秒。等我复制内容后，用一句话总结。”

往返处理：

“读取我的剪贴板，将内容翻译成德语，再把译文写回剪贴板。”

数据转换：

复制一个 CSV 表格 → “将剪贴板中的内容转换为 JSON” → 将格式化后的 JSON 粘贴到编辑器中。

根据剪贴板内容编写代码：

从浏览器复制一段代码 → “检查剪贴板中的代码是否有错误” → Claude 会直接读取代码，无需粘贴到聊天中。

通过剪贴板历史记录查看 Agent 的逐步输出：

执行多步骤任务，并在每个步骤后调用 set_clipboard。使用任意剪贴板管理器（Paste、CopyQ、Klipper），即可获得每项结果的时间顺序记录 — 浏览、搜索和查看 Agent 的工作过程，无需切换窗口。

平台支持

• Windows（x86_64）— 剪贴板通过操作系统剪贴板板持久保存
• macOS（x86_64、aarch64）— 剪贴板通过操作系统剪贴板板持久保存
• Linux（x86_64、aarch64）— 支持 X11 和 Wayland（通过 wl-data-control 协议）

Linux 注意事项： 在 Linux 上，服务写入的剪贴板内容会由后台线程保持有效。如果没有运行剪贴板管理器（例如 i3/dwm 这类裸窗口管理器），请安装 clipman、parcellite 或 copyq。

工作原理

单个二进制文件。使用 arboard（由 1Password 提供）访问原生剪贴板。通过 MCP 协议经由标准输入输出（默认）或 HTTP（--http 标志，Streamable HTTP 传输）进行通信。在 Windows 和 macOS 上没有运行时依赖；Linux 需要 X11 库，或支持 wl-data-control 的 Wayland 合成器。

故障排除

Linux：剪贴板内容消失 确保正在运行剪贴板管理器。在纯窗口管理器（i3、dwm）上，请安装 clipman、parcellite 或 copyq。

Wayland：“剪贴板为空或包含非文本内容” 你的合成器必须支持 wl-data-control 协议。Sway、Hyprland、GNOME 和 KDE 均支持该协议。较旧的合成器可能不支持。

macOS：剪贴板访问被拒绝 确保在“系统设置”>“隐私与安全性”中，为运行 MCP 服务的终端授予剪贴板权限。

安全性

此服务会向已连接的 MCP 客户端授予对系统剪贴板的完整读写权限：

• get_clipboard / get_clipboard_html — 原样返回剪贴板内容
• set_clipboard — 静默覆盖剪贴板内容（最大 1 MB）
• watch_clipboard — 原样返回你复制的下一项内容
• clear_clipboard — 不经确认即清空剪贴板

仅将此服务连接到你信任的 AI 会话。请勿在剪贴板上可能包含敏感数据（密码、令牌）的环境中使用。

**HTTP 模式：**默认绑定地址为 127.0.0.1（仅限本地主机）。使用 --host 绑定到 0.0.0.0 会将剪贴板暴露给所有可访问的网络接口。浏览器发起的请求（带有 Origin 标头）会被拒绝并返回 403。此服务没有身份验证机制——非浏览器 HTTP 客户端不受限制。需要远程访问时，建议使用 SSH 隧道，而不是将服务暴露到网络。

贡献

欢迎提交错误报告和拉取请求。对于重大更改，请先提出议题。

许可证

MIT