MCP Windows Clipboard

mcp窗口剪贴板

AI编码助手通过模型上下文协议访问本地Windows剪贴板

 ](https://nodejs.org) 

问题解决了

剪贴板图像粘贴不起作用 在Windows上的许多AI编码助手中。此MCP服务器提供了一个可靠的桥梁，可以从Claude Code、OpenCode、Cursor和其他MCP兼容工具访问Windows剪贴板内容（包括图像）。

特性

• 图像支持 -从剪贴板读取PNG、BMP和DIB图像
• 文本支持 -从剪贴板读取文本内容
• 自动检测 -自动检测内容类型
• 自动粘贴 -按Ctrl+V时自动捕获剪贴板内容
• AI分析就绪 -缓存的粘贴已准备好供AI按需分析
• 文件输出 -将图像直接保存到文件中，以便与其他工具一起使用
• Base64输出 -获取base64格式的图像数据以供内联使用
• 非阻塞 -自动粘贴监控不会干扰正常的粘贴操作

快速开始

安装

npm install -g mcp-windows-clipboard

或者从源代码安装：

git clone https://github.com/marco-jardim/mcp-windows-clipboard.git
cd mcp-windows-clipboard
npm install
npm run build

配置

添加到MCP客户端配置中：

OpenCode(~/.config/opencode/opencode.json)

{
  "mcp": {
    "windows-clipboard": {
      "type": "local",
      "command": ["node", "C:/path/to/mcp-windows-clipboard/dist/index.js"],
      "environment": {},
      "enabled": true
    }
  }
}

克劳德桌面(%APPDATA%\Claude\claude_desktop_config.json)

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

光标/VS代码

添加到MCP扩展设置中：

{
  "mcp.servers": {
    "windows-clipboard": {
      "command": "mcp-windows-clipboard"
    }
  }
}

可用工具

read_clipboard

读取当前剪贴板内容。直接返回文本或base64编码的图像数据。

参数：

• format （可选）： "auto" | "text" | "image" -强制特定格式检测

示例用法：

Read my clipboard and tell me what's there

read_clipboard_image

从剪贴板读取图像并将其保存到文件中。返回图像分析工具使用的文件路径。

参数：

• outputPath （可选）：保存图像的自定义路径

示例用法：

Save my clipboard image to a file and analyze it

clipboard_has_image

检查剪贴板当前是否包含图像。

示例用法：

Do I have an image in my clipboard?

get_last_paste

获取最近粘贴的内容（按Ctrl+V时自动捕获）。直接返回文本内容或图像的文件路径。这是自动粘贴功能的关键工具。

示例用法：

What did I just paste?
Analyze my last paste

autopaste_status

检查自动粘贴监控是否处于活动状态，并获取有关上次捕获的粘贴的信息。

示例用法：

Is autopaste working?

clear_paste_cache

清除缓存的粘贴内容。对隐私或重置状态有用。

示例用法：

Clear my paste history

使用示例

基本图像粘贴工作流

1. 截图(Win+Shift+S)
2. 问你的AI助手： *“我的剪贴板里有什么？”*
3. 助理将阅读并描述图像

保存并分析

1. 复制图像或屏幕截图
2. 问： *“保存我的剪贴板图像并对其进行分析”*
3. 图像保存到temp文件夹并进行分析

文本内容

1. 复制一些文本(Ctrl+C)
2. 问： *“阅读我的剪贴板”*
3. 直接返回文本内容

自动粘贴工作流（新增！）

自动粘贴功能会自动捕获您粘贴的任何内容，因此AI可以对其进行分析，而无需您明确请求剪贴板读取：

1. 复制某些内容（文本或图像）
2. 按 Ctrl+V 将其粘贴到任何位置（您的正常粘贴按预期工作）
3. 问你的AI助手： *“我刚才贴了什么？”* 或 *“分析我上次粘贴的内容”*
4. AI使用 get_last_paste 检索和分析内容

这对于以下情况特别有用：

• 粘贴截图后快速图像分析
• 查看刚刚粘贴的内容
• 无缝工作流程，无需显式剪贴板命令

运作原理

此MCP服务器使用PowerShell访问本机Windows剪贴板API：

1. 图像检测：检查 [System.Windows.Forms.Clipboard]::ContainsImage()
2. 图像读取：用途 [System.Windows.Forms.Clipboard]::GetImage() 并另存为PNG
3. 文本阅读：用途 [System.Windows.Forms.Clipboard]::GetText()

自动粘贴技术

自动粘贴功能使用 uiohook纳帕 对于非阻塞全局键盘监控：

• 非阻塞：键盘事件被观察到，而不是被拦截-正常的Ctrl+V粘贴总是有效的
• 自动缓存：检测到Ctrl+V时，剪贴板内容会自动读取并缓存
• 优雅降级：如果键盘挂钩初始化失败，所有其他剪贴板工具将继续正常工作

核心功能不需要外部依赖或本机二进制文件，只需要Node.js和PowerShell（包含在Windows中）。

需求

• Windows 10/11 -使用Windows特定的剪贴板API
• Node.js 18+ -ES模块支持所需
• PowerShell -随Windows附带，无需额外设置

故障排除

“剪贴板是空的”当它不是

1. 确保内容已正确复制（请尝试 Ctrl+C 再次）
2. 某些应用程序使用不支持的自定义剪贴板格式
3. 尝试从其他应用程序复制

PowerShell错误

1. 确保PowerShell执行策略允许脚本：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

MCP连接问题

1. 验证配置中的路径是否正确
2. 检查Node.js是否在您的PATH中
3. 试着跑步 mcp-windows-clipboard 直接进行测试

图像未保存

1. 检查输出目录中的写入权限
2. 尝试指定自定义 outputPath
3. 确保有足够的可用磁盘空间

发展

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

贡献

欢迎投稿！拜托：

1. 克隆该仓库
2. 创建要素分支
3. 进行更改
4. 运行测试： npm test
5. 提交拉取请求

许可证

此项目根据GNU通用公共许可证v3.0获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 模型上下文协议 通过Anthropic
• 受到社区面临的WSL剪贴板挑战的启发

相关项目

• mcp剪辑 -WSL2的基于Go的MCP剪贴板
• mcp剪贴板 -持久剪贴板管理器

______________________________________________________________________

带着挫败感和决心 -因为粘贴图像应该没那么难。