使用说明

项目简介

Clipboard MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于将macOS系统剪贴板中的图像内容以标准化的方式提供给支持 MCP 协议的 LLM 客户端，例如 Claude。它作为一个工具 (Tool) 注册到 MCP 服务器中，LLM 可以通过调用该工具获取剪贴板中的图像，从而理解和处理用户上下文中包含的图像信息。

主要功能点

剪贴板图像访问: 提供工具 (Tool) 允许 LLM 获取 macOS 剪贴板中的图像数据。
PNG 格式支持: 目前仅支持剪贴板中的图像内容为 PNG 格式。
Base64 编码: 将图像数据编码为 Base64 字符串，方便在 JSON-RPC 中传输。
MCP 协议兼容: 遵循 MCP 协议规范，易于与支持 MCP 的 LLM 客户端集成。

安装步骤

安装 Go 语言环境: 确保你的 macOS 系统已安装 Go 语言环境 (version 1.16 或更高版本)。如果未安装，请访问 https://go.dev/dl/ 下载并安装。
安装 Clipboard MCP Server: 打开终端应用程序，运行以下命令安装 'clipboard-mcp'：
```
go install github.com/oxplot/clipboard-mcp@latest
```
安装成功后，'clipboard-mcp' 可执行文件将被放置在 '$GOPATH/bin' 或 '$GOBIN' 目录下 (取决于你的 Go 环境配置)。你需要将此目录添加到你的系统 'PATH' 环境变量中，以便在任何位置直接运行 'clipboard-mcp' 命令。

服务器配置

MCP 客户端需要配置 Clipboard MCP Server 的启动命令才能连接。以下是一个 JSON 格式的配置示例，你需要将其添加到你的 MCP 客户端配置中。

{
  "serverName": "clipboard",
  "command": "clipboard-mcp",
  "args": []
}

配置参数说明:

'serverName': MCP 服务器的名称，这里设置为 'clipboard'，用于在客户端中唯一标识该服务器。
'command': 启动 MCP 服务器的命令。这里设置为 'clipboard-mcp'，假设 'clipboard-mcp' 可执行文件已添加到系统 'PATH' 环境变量中。如果未添加到 'PATH'，你需要提供 'clipboard-mcp' 可执行文件的完整路径。
'args': 启动命令的参数。此服务器不需要额外的启动参数，因此设置为空数组 '[]'。

基本使用方法

复制图像到剪贴板: 在 macOS 系统中，将你想要 LLM 分析的图像复制到剪贴板。例如，你可以截图或复制图片文件。
配置 MCP 客户端: 根据你的 MCP 客户端 (例如 Claude Code CLI) 的文档，添加上述服务器配置信息。
在 LLM 中调用工具: 在 LLM 客户端中，你可以通过自然语言指令指示 LLM 使用 'image_paste' 工具来获取剪贴板中的图像。例如，你可以向 Claude 提问类似于 "What's wrong with the code in the image from clipboard?" (剪贴板图像中的代码有什么问题？) 的问题。 Claude (或其他支持 MCP 的 LLM 客户端) 将会自动调用 'clipboard-mcp' 服务器提供的 'image_paste' 工具，并将剪贴板中的图像内容作为上下文发送给 LLM 进行分析。

注意:

目前该服务器仅支持 macOS 系统。
确保剪贴板中包含 PNG 格式的图像，否则工具可能无法正常工作。
客户端的具体使用方式可能因 MCP 客户端实现而异，请参考你使用的 MCP 客户端的文档。

关键词