Clipboard Mcp Server

Clipboard MCP サーバー

LLM モデルが関連する出力をシステムのクリップボードに直接保存し、すぐに使えるようにする MCP サーバーです。

注意事項

Linux と MacOS でテスト済みです。

機能

この MCP サーバーは、Claude Code（またはその他の MCP 互換ツール）が次の操作を行えるようにするツールを提供します。

• コマンドのスニペットをクリップボードに直接保存します（例：npm install express）。
• エディターに貼り付けられるコードのスニペットを保存します。
• 都市名、数字、特定の値など、短い回答を保存します。
• すぐに使えるよう、任意のテキストコンテンツを保存します。

使用例

「Express.js をインストールするにはどうすればよいですか？」と尋ねると：

• Claude が Express.js について詳しく説明します。
• さらに、貼り付けられるように npm install express を自動的にクリップボードに保存します。

「ハンガリーの首都はどこですか？」と尋ねると：

• Claude が首都はブダペストであると説明します。
• さらに、すぐに使えるよう Budapest だけをクリップボードに保存します。

デモ

LM Studio と連携する Clipboard MCP サーバーの動作例。詳しい回答を提供しながら、便利なコンテンツを自動的にクリップボードに保存します。

クイックスタート

自動セットアップ（推奨）

./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 = "")

任意で説明を付けて、ターミナル／シェルコマンドを保存するためのツールです。

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

任意で言語情報を付けて、コードのスニペットを保存するためのツールです。

テスト

サーバーを直接実行してテストします。

python server.py

サーバーが起動し、MCP プロトコルのメッセージを待機します。クリップボード機能のテストには、Claude Code やその他の MCP クライアントを使用してください。