通过MCP实现剪贴板AI集成:clipboard-mcp服务器
像Claude Desktop和Claude Code这样的AI助手无法直接访问系统剪贴板。这迫使用户在工作流中多走几步:复制错误信息 → 粘贴到聊天框 → 获取修复建议 → 再次复制回编辑器。而基于Rust开发的clipboard-mcp服务器,通过模型上下文协议(MCP)提供读取、写入和监控剪贴板三大功能,彻底解决这一痛点。
核心服务器工具
clipboard-mcp 实现了一个具备以下功能的MCP服务器:
- get_clipboard:直接获取剪贴板内容。AI可即时接收数据,无需手动粘贴至对话框。
- set_clipboard:将处理结果写回剪贴板,随时可通过 Ctrl+V 在编辑器或终端中使用。
- watch_clipboard:通过轮询方式监控剪贴板变化,默认超时30秒,最长可达5分钟。
一个仅约250行代码的二进制文件,无运行时依赖,支持 Windows、macOS(Intel/Apple Silicon)以及 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。
实际应用场景
双向处理流程
仅需两步完成:复制 → 处理 → 结果返回剪贴板
- 报错日志 → 输入「修复这个问题」→ 修复方案即刻准备就绪,可直接粘贴。
- 文本内容 → 「翻译成德语」→ 翻译结果自动存入剪贴板。
- JSON 数据 → 「格式化」→ 输出整洁结构化的结果。
数据转换
Excel中的CSV → 「转为JSON」→ 格式化后的JSON可直接插入代码。特别适用于YAML↔JSON、Markdown→HTML、XML等格式互转场景。
剪贴板实时监控
「持续监听60秒,每次按Ctrl+C都自动分析代码」。AI能即时响应每一次复制操作,无需切换窗口。
代码审查
从GitHub复制代码片段 → 按下Ctrl+C → 输入「检查是否存在漏洞」。完整保留原始格式,无需再粘贴到聊天框中。
剪贴板历史流式输出
智能体在每一步调用 set_clipboard。配合剪贴板管理工具(如KDE或GNOME),即可实时查看中间处理结果的动态流。
技术实现细节
基于 rmcp(MCP的Rust SDK)、arboard(跨平台剪贴板库)和 tokio(单线程运行时)构建。
剪贴板操作在 spawn_blocking 中执行,避免阻塞MCP服务器主流程。采用标准输入输出传输JSON-RPC协议。
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行Rust代码。
- 提供读取、写入、监控剪贴板三大核心功能,无缝集成Claude Desktop与Code。
- 兼容所有桌面环境,包括Wayland;安全性由用户自行把控。
— Editorial Team
暂无评论。