Linux Clipboard MCP Server (wayland)

mcp-wayland-clipboard

wl-copy を介して Wayland のクリップボードに書き込む MCP サーバーです。

この Model Context Protocol（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

サーバーは、text パラメーターを受け取り、Wayland のクリップボードにコピーする copy_to_clipboard という単一のツールを提供します。

パラメーター：

• 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