snip-mcp

画面領域を直接Claude Codeの会話に取り込めるMCPサーバーです。ホットキーやツール呼び出しを使用して画面の任意の領域を選択すると、スクリーンショットが即座に画像としてコンテキスト内で利用可能になります。

機能

• ホットキーキャプチャ -- Ctrl+Shift+クリックで、いつでもどこでもスニッピングオーバーレイを開けます

• ツール起動キャプチャ -- Claudeがユーザーの代わりにスニッピングツールを呼び出せます

• マルチモニター対応 -- DPIを認識し、接続されているすべてのディスプレイで動作します

• 永続ストレージ -- スニップはディスクに保存され、サーバーを再起動しても保持されます

• 自動削除 -- 設定可能な制限により、ストレージの無制限な増加を防ぎます

• トースト通知 -- スニップがキャプチャされた際の視覚的な確認

Related MCP server: Shotik

要件

• Windows 10以降 (ctypesを介したWindows固有のグローバルマウスフックを使用)

• Python 3.11以上

インストール

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
pip install -e .

またはuvを使用する場合:

git clone https://github.com/Alparse/snip-mcp.git
cd snip-mcp
uv pip install -e .

Claude Codeの設定

Claude CodeのMCP設定にサーバーを追加します。

pipでインストールした場合 (グローバルまたはvenv)

~/.claude/settings.json (グローバル) または .claude/settings.json (プロジェクト) に以下を記述します:

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

uvを使用する場合 (分離環境として推奨)

{
  "mcpServers": {
    "snip": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/snip-mcp", "snip-mcp"]
    }
  }
}

使用方法

ホットキーキャプチャ

画面上の任意の場所で Ctrl+Shift+左クリック を押すと、スニッピングオーバーレイが開きます:

1. クリック＆ドラッグで領域を選択

2. 放すとキャプチャ

3. Escape キーでキャンセル

トースト通知でキャプチャが確認できます。

ツール起動キャプチャ

Claudeにスクリーンショットを撮るよう依頼すると、snip_screenツールが呼び出され、オーバーレイが開きます。

スニップの管理

Claudeは以下のMCPツールを利用できます:

設定

設定は ~/.snip_mcp/config.json に保存され、初回実行時に自動作成されます。

設定例:

{
  "modifier_keys": ["ctrl", "shift"],
  "save_directory": "C:/Users/you/.snip_mcp/snips",
  "overlay_alpha": 0.3,
  "selection_color": "#00ff00",
  "selection_width": 2,
  "max_snips": 50
}

トラブルシューティング

"snip-mcp requires Windows" このサーバーはWindows固有のAPI (ctypesを介したグローバルマウスフック) を使用しています。macOSやLinuxでは実行できません。

"Failed to install mouse hook" グローバルマウスフックには管理者権限が必要な場合があります。ターミナルを管理者として実行してみてください。

オーバーレイが表示されない 他のアプリケーションがCtrl+Shift+Clickを横取りしていないか確認してください。設定ファイルの modifier_keys を確認してください。

高DPIディスプレイで座標がずれる サーバーは起動時に SetProcessDPIAware() を呼び出します。それでもずれが発生する場合は、Windowsのディスプレイ拡大縮小設定を確認してください。

スニップディレクトリ デフォルトでは、スニップは ~/.snip_mcp/snips/ に保存されます。これは config.json で変更可能です。

ライセンス

MIT -- 詳細は LICENSE を参照してください。