Clipboard Mcp

clipboard-mcp

AI アシスタントにシステムのクリップボードへの直接的な読み取り／書き込みアクセスを提供する、クロスプラットフォーム対応のModel Context Protocol（MCP）サーバーです。ウェブサイト

エラーをコピー → Claude に修正を依頼 → 修正内容がクリップボードに保存されます。チャットへの手動貼り付けや、回答からの手動コピーは不要です。

cargo install clipboard-mcp

clipboard-mcp を選ぶ理由

• 単一バイナリ — Python、Node.js、ランタイムのインストールは不要です
• ネイティブのクリップボード — pbcopy／xclip のようなシェルコマンドではなく、1Password の arboard を使用します
• 監視モード — watch_clipboard を使うと、エージェントはコピーされた内容にリアルタイムで反応できます
• HTML と形式の検出 — HTML コンテンツの読み取りや、利用可能なクリップボード形式の確認ができます
• クロスプラットフォーム対応 — Windows、macOS（Intel ＋ Apple Silicon）、Linux（X11 ＋ Wayland）
• HTTP トランスポート — リモートエージェントからアクセスできるローカル HTTP サーバーとして実行できます

ツール

ツール	説明
get_clipboard	クリップボードから現在のテキストを読み取ります。100 KB を超えるコンテンツは切り詰められます。
get_clipboard_html	クリップボードから HTML コンテンツを読み取ります（ブラウザーのリッチテキストなど）。
set_clipboard	テキストをクリップボードに書き込みます（最大 1 MB）。
watch_clipboard	クリップボードのテキストが変わるまで待機します（デフォルト 30 秒、最大 300 秒）。同時実行は最大 5 件です。
list_clipboard_formats	利用可能な形式（テキスト、HTML、画像、ファイル）を確認します。
clear_clipboard	クリップボードのコンテンツをすべて消去します。

watch_clipboard のパラメーター

パラメーター	型	デフォルト	説明
timeout_secs	整数（任意）	30	変更を待機する秒数（最大 300）

インストール

cargo install clipboard-mcp

または、GitHub Releases からバイナリをダウンロードしてください。

設定

Claude Desktop（stdio、デフォルト）

claude_desktop_config.json に追加します。

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

Claude Code（stdio）

# Add for current project
claude mcp add clipboard clipboard-mcp

# Or add globally
claude mcp add --scope user clipboard clipboard-mcp

HTTP トランスポート

リモートまたはプログラムからアクセスできる HTTP サーバーとして実行します。

clipboard-mcp --http                          # 127.0.0.1:3100
clipboard-mcp --http --port 8080              # custom port
clipboard-mcp --http --host 0.0.0.0           # expose to network (see Security)

MCP エンドポイント：http://HOST:PORT/mcp

使用例

読み取りと変換：

「クリップボードにある内容を何でも、よりフォーマルな文体に書き直して、結果をクリップボードに戻してください。」

変更の監視：

「クリップボードを 60 秒間監視してください。何かをコピーしたら、1 文で要約してください。」

往復処理：

「クリップボードの内容を取得し、ドイツ語に翻訳して、その翻訳をクリップボードに設定してください。」

データ変換：

CSV テーブルをコピー → 「クリップボードの内容を JSON に変換してください」 → 書式設定された JSON をエディターに貼り付けます。

クリップボードからコードを取得：

ブラウザーからコードスニペットをコピー → 「クリップボードにあるコードのバグをレビューしてください」 → Claude がチャットに貼り付けなくても直接読み取ります。

クリップボード履歴を使ったエージェントの段階的な出力：

複数段階のタスクを実行し、各段階の後に set_clipboard を実行します。クリップボードマネージャー（Paste、CopyQ、Klipper など）を使えば、各結果の時系列ログが作成されます。ウィンドウを切り替えることなく、エージェントの作業を閲覧、検索、確認できます。

プラットフォームのサポート

• Windows（x86_64）— クリップボードの内容は OS のペーストボードを介して保持されます
• macOS（x86_64、aarch64）— クリップボードの内容は OS のペーストボードを介して保持されます
• Linux（x86_64、aarch64）— X11 および Wayland（wl-data-control プロトコル経由）

Linux に関する注意： Linux では、サーバーが設定したクリップボードの内容はバックグラウンドスレッドによって維持されます。クリップボードマネージャーが実行されていない場合（i3／dwm などの最小構成のウィンドウマネージャー）、clipman、parcellite、または copyq をインストールしてください。

仕組み

単一のバイナリです。ネイティブのクリップボードアクセスには、arboard（1Password 製）を使用します。MCP プロトコルを介して、stdio（デフォルト）または HTTP（--http フラグ、Streamable HTTP トランスポート）で通信します。Windows と macOS では実行時の依存関係はありません。Linux では X11 ライブラリ、または wl-data-control をサポートする Wayland コンポジターが必要です。

トラブルシューティング

Linux：クリップボードの内容が消える クリップボードマネージャーが起動していることを確認してください。ベアなウィンドウマネージャー（i3、dwm）では、clipman、parcellite、または copyq をインストールしてください。

Wayland：「クリップボードが空、またはテキスト以外のコンテンツが含まれています」 コンポジターが wl-data-control プロトコルをサポートしている必要があります。Sway、Hyprland、GNOME、KDE はいずれもサポートしています。古いコンポジターではサポートされていない場合があります。

macOS：クリップボードへのアクセスが拒否される MCP サーバーを実行しているターミナルに、システム設定 > プライバシーとセキュリティでクリップボードへのアクセス許可があることを確認してください。

セキュリティ

このサーバーに接続した MCP クライアントは、システムのクリップボードに対する完全な読み取り／書き込みアクセスを取得します。

• get_clipboard / get_clipboard_html — クリップボードの内容をそのまま返します
• set_clipboard — 確認なしでクリップボードの内容を上書きします（最大 1 MB）
• watch_clipboard — 次にコピーする内容をそのまま返します
• clear_clipboard — 確認なしでクリップボードを消去します

信頼できる AI セッションにのみ、このサーバーを接続してください。パスワードやトークンなどの機密データがクリップボードにある可能性のある環境では使用しないでください。

HTTP モード： デフォルトのバインド先は 127.0.0.1（ローカルホストのみ）です。--host を指定して 0.0.0.0 にバインドすると、到達可能なすべてのネットワークインターフェースにクリップボードが公開されます。ブラウザーから開始されたリクエスト（Origin ヘッダー付き）は 403 で拒否されます。認証機能はありません。ブラウザー以外の HTTP クライアントは制限されません。リモートアクセスには、ネットワークに公開するのではなく SSH トンネリングを使用してください。

コントリビューション

バグ報告やプルリクエストを歓迎します。大きな変更を行う場合は、まず issue を作成してください。

ライセンス

MIT