Linux Clipboard MCP Server (wayland)

mcp-wayland-clipboard

通过 wl-copy 写入 Wayland 剪贴板的 MCP 服务。

此模型上下文协议（MCP）服务允许 AI 模型使用 wl-copy 命令行工具将文本直接复制到 Wayland 剪贴板。

前置条件

• Node.js（v18 或更高版本）
• 已安装 wl-copy，且可在 PATH 中找到（通常由 wl-clipboard 软件包提供）

安装 wl-clipboard

在 Arch Linux 上：

sudo pacman -S wl-clipboard

在 Ubuntu/Debian 上：

sudo apt install wl-clipboard

安装

npm install

构建

npm run build

这会将 TypeScript 源码编译为 dist/ 目录中的 JavaScript。

使用方法

启动服务

构建完成后，可以使用以下命令启动服务：

npx mcp-wayland-clipboard

也可以直接使用 Node 启动：

node dist/index.js

工具：copy_to_clipboard

该服务提供一个名为 copy_to_clipboard 的工具，接受一个 text 参数，并将文本复制到 Wayland 剪贴板。

参数：

• text（字符串，必需）：要复制到剪贴板的文本

返回值：

• 成功：{ success: true, message: "Text copied to clipboard" }
• 错误：{ success: false, error: "error message" }

使用示例

一种常见用法是让 AI 生成公式或代码片段，并自动将其复制到剪贴板。例如：

“生成一个对 A1 到 A5 单元格求和的 Excel 公式，并复制到我的剪贴板”

随后，AI 可以调用 copy_to_clipboard 工具并传入公式，你就可以将其直接粘贴到 Excel 中。

MCP 客户端配置

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中（在 macOS 上通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Linux 上通常位于 ~/.config/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "wayland-clipboard": {
      "command": "npx",
      "args": ["-y", "mcp-wayland-clipboard"]
    }
  }
}

如果你已在本地安装该项目，也可以使用：

{
  "mcpServers": {
    "wayland-clipboard": {
      "command": "node",
      "args": ["/path/to/mcp-wayland-clipboard/dist/index.js"]
    }
  }
}

其他 MCP 客户端

对于其他 MCP 客户端，将其配置为使用以下方式启动服务：

• 命令：npx（如果使用本地安装，则使用 node）
• 参数：["-y", "mcp-wayland-clipboard"]（本地安装则使用 ["/path/to/dist/index.js"]）

错误处理

如果启动时在 PATH 中找不到 wl-copy，服务将以错误代码退出。请确保在运行服务前已安装 wl-clipboard。

许可证

MIT