Clipboard Mcp Server

剪贴板 MCP 服务

一个 MCP 服务，可让大模型将相关输出直接保存到系统剪贴板，以便立即使用。

注意

已在 Linux 和 MacOS 上测试

功能

此 MCP 服务提供的工具可让 Claude Code（或其他兼容 MCP 的工具）：

• 将命令片段直接保存到剪贴板（例如，npm install express）
• 将可直接粘贴到编辑器中的代码片段保存到剪贴板
• 将城市名称、数字或特定值等简短答案保存到剪贴板
• 将任何文本内容保存到剪贴板，以便立即使用

使用示例

当你询问：“如何安装 Express.js？”

• Claude 会提供关于 Express.js 的完整说明
• 并且会自动将 npm install express 放入剪贴板，供你直接粘贴

当你询问：“匈牙利的首都是哪里？”

• Claude 会解释布达佩斯是匈牙利的首都
• 并且会将 Budapest 放入剪贴板，方便快速使用

演示

剪贴板 MCP 服务与 LM Studio 配合使用时，会在提供完整回答的同时自动将有用内容保存到剪贴板

快速开始

自动设置（推荐）

./setup.sh

此操作将：

• 安装系统依赖项（Linux 上的 xclip）
• 创建 Python 虚拟环境
• 安装所有必需的软件包
• 显示要添加到 MCP 客户端的配置

手动设置

1. 安装依赖项：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. 安装剪贴板支持（仅限 Linux）：

sudo apt install xclip

运行服务

简易启动

./start.sh           # Default port 3001
./start.sh 3002      # Custom port 3002

手动启动

source .venv/bin/activate
python server.py                # Default port 3001
python server.py --port 3002    # Custom port 3002
python server.py --help         # See all options

服务将在 http://localhost:PORT/sse 上运行，并提供剪贴板功能。

MCP 客户端配置

将此配置添加到 MCP 客户端：

Claude Code（~/.claude.json）：

{
  "mcpServers": {
    "clipboard": {
      "type": "sse",
      "url": "http://localhost:3001/sse"
    }
  }
}

使用自定义端口时，请相应更新 URL：

{
  "mcpServers": {
    "clipboard": {
      "type": "sse",
      "url": "http://localhost:3002/sse"
    }
  }
}

LM Studio 和其他 MCP 客户端使用相同的配置格式。

此服务适用于任何支持 SSE 传输的兼容 MCP 客户端。

可用工具

save_to_clipboard(content: str)

用于保存任何文本内容的通用剪贴板保存工具。

save_command_to_clipboard(command: str, description: str = "")

专用于终端/ shell 命令，可选添加说明。

save_code_to_clipboard(code: str, language: str = "")

用于代码片段，可选指定语言上下文。

测试

直接运行服务进行测试：

python server.py

服务启动后将等待 MCP 协议消息。可搭配 Claude Code 或其他 MCP 客户端测试剪贴板功能。