slimsnap

SlimSnap コネクター

最近のスクリーンキャプチャを、AI が実際に読み取れる構造化データにします。

SlimSnap でキャプチャを撮り、意図する箇所をマークしてから、Claude や Cursor で「直近のキャプチャを見て」と伝えてください。貼り付けも、ファイルパスも、クリップボードも必要ありません。

エージェントが取得するもの

スクリーンショットではありません。JSON ドキュメントです。画面上のすべてのテキストとその位置や色に加えて、描画した矢印、ボックス、吹き出し、そしてそれぞれが指している要素が含まれます。

これが重要なのには、3 つの理由があります。

エージェントに貼り付けたスクリーンショットは、モデルが読む前に縮小されますが、そのことは知らされません。Anthropic の公式ドキュメントでも、画像のサイズ変更は「テキストを読みづらくする可能性がある」ため、事前に画像をリサイズして切り抜くよう案内しています。縦長のページでは、テキストが完全に失われます。

MCP 経由で返される画像は、さらに問題があります。Claude Code では、ネイティブの画像ブロックではなくテキストとして渡されるため、同じ画像を直接貼り付けた場合の約 1.6k トークンに対し、約 15～25k トークンを消費し、モデルは画像をまったく読み取れません（claude-code#31208、対応予定なしとしてクローズ）。結果が大きすぎると、1 回の結果に対するトークン上限を超えてしまいます（#9152）。

さらに、大きすぎるスクリーンショットはセッションを恒久的に損なう可能性があります。コンテキストに残り、ターンごとに再送信され、削除する方法もありません（#55040）。

このコネクターは画像を一切送信しないことで、3 つすべての問題を回避します。通常の画面なら、画像として送る場合と比べて約 3 分の 1 少ないコストで済みます。縦長のページでは、もはやコストの比較ではありません。18,410 ピクセルのページをモデルの 1568 ピクセルの上限に合わせて縮小すると、本文の文字の高さは 1.4 ピクセルになり、画像が安いのは読めないからです。どちらの場合も、エージェントは、どのボタンのことか推測するのではなく、正確な座標を取得します。

見た目のスタイル、余白、色のバランスなど、実際にピクセルが必要な場合には専用のツールがあり、画像はモデルが読み取れるサイズにあらかじめ縮小されています。

インストール

Claude Code

claude mcp add slimsnap -- npx -y @slimsnap/mcp

続いて確認します。/mcp を実行すると、slimsnap と 4 つのツールが表示されます。

Claude Desktop

Releases から slimsnap-mcp.mcpb をダウンロードして開きます。Claude にインストールダイアログが表示されます。その後、このコネクターが設定に表示されます。

Cursor

または、プロジェクト内の .cursor/mcp.json、あるいはすべてのプロジェクトに適用する場合は ~/.cursor/mcp.json に手動で追加します。

{
  "mcpServers": {
    "slimsnap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@slimsnap/mcp"]
    }
  }
}

両方に設定がある場合、プロジェクトの設定がグローバル設定より優先されます。その後は、Claude に尋ねるのと同じように、直近のキャプチャについて Cursor に尋ねてください。

Claude Code プラグインとして（同じコネクターをプラグインとしてインストール・更新します）

/plugin marketplace add bickov/slimsnap-mcp
/plugin install slimsnap@slimsnap

最近のキャプチャをディスクに保存するようになったバージョンのため、SlimSnap 0.5.0 以降が必要です。

ツールの承認

Claude Code が各ツールを初めて使用するときに、権限を求めます。承認は、そのときにいたフォルダーに適用されます。ツールは 4 つあるため、確認も 4 回表示され、次のプロジェクトでも再び表示されます。問題ではありません。Claude Code が MCP ツールに対してこのように権限を管理しています。

すべての場所で一度だけ承認するには、これを ~/.claude/settings.json に追加します。

{
  "permissions": {
    "allow": [
      "mcp__slimsnap__get_latest_capture",
      "mcp__slimsnap__list_captures",
      "mcp__slimsnap__get_capture",
      "mcp__slimsnap__get_capture_image"
    ]
  }
}

ファイルがすでに存在する場合は、置き換えるのではなく、allow の項目を統合してください。その後、Claude Code を再起動します。

ツール

ツール	機能
get_latest_capture	最新のキャプチャを構造化 JSON で取得します。最もよく使われるツールです。
list_captures	最近のキャプチャを新しい順に、テキストプレビュー付きで一覧表示します。古いキャプチャを探すときや、マークした画面を複数まとめて確認するときに使います。
get_capture	ID を指定してキャプチャを 1 件取得します。
get_capture_image	JSON では質問に答えられない場合に、フレーム 1 枚を縮小画像として取得します。

ツールは意図的に 4 つに絞っています。ツールの説明はターンごとにコンテキストウィンドウを消費するため、提供する機能は最小限にしています。

実際のキャプチャを見る

samples/ には、1 画面のものと 3 フレームのスクロールキャプチャの 2 つのサンプルキャプチャがあります。どちらも、矢印は指している要素に対応付けられています。どちらかを ~/.slimsnap/recent/ にコピーすると、コネクタが読み込みます。SlimSnap をインストールする前に、4 つのツールすべてを試せます。

mkdir -p ~/.slimsnap/recent
cp -R samples/single-frame ~/.slimsnap/recent/2026-07-30T09-00-00-000000-00-00

次に、エージェントに 最後のキャプチャで何をマークしましたか？ と尋ねてください。変更を保存ボタンと、それに付けたメモが返ってくるはずです。

データの保存場所

SlimSnap は最近のキャプチャを ~/.slimsnap/recent/ に保存します。デフォルトでは最新の 20 件です。各キャプチャはフォルダーに保存され、capture.json、小さなインデックスファイル meta.json、そして長辺が最大 1568px の各フレームの PNG が含まれます。

コネクタは ~/.slimsnap/config.json を読み込んで、そのフォルダーを特定します。このファイルは設定が変更されるたびに SlimSnap によって書き換えられます。保存先フォルダーを移動しても、再設定することなくコネクタが追従します。

保存する件数を変更したり、キャッシュを完全に無効にしたりするには、SlimSnap の「設定」、「エクスポート」、「最近のキャプチャ」の順に開きます。同じ場所に「クリア」ボタンがあります。

プライバシーポリシー

サーバーはホームディレクトリ内のファイルを読み取りますが、外部とは通信しません。ネットワークコードは含まれていません。画面をキャプチャすることも、SlimSnap に画面のキャプチャを依頼することもできません。すでに撮影し、保存を選択したキャプチャだけを読み取ります。

アップロードは行われず、アカウントも不要で、テレメトリーもありません。

個人データの収集、保存、送信、共有は行いません。サーバーにはネットワークコードも分析機能もありません。ポリシー全文：https://slimsnap.ai/privacy。

要件

SlimSnap 0.5.0 以降、macOS または Windows。Claude Code、Claude Desktop、Cursor で動作します。

Codex はまだサポートされていません。1 回のツール結果の上限が約 10 KB のため、実際のキャプチャでは上限を超えます。また、構造化出力があると画像コンテンツが削除されます（codex#7906、#10334）。どちらも上流で対応が進められています。

Claude Desktop を使う場合、追加の準備は不要です。Desktop には独自の Node が付属しており、.mcpb バンドルもそれを使用します。Claude Code を使う場合は、PATH 上の node が実行されるため、Node 18 以降をインストールする必要があります。新しい Windows マシンでは Node が通常インストールされていないため、見落としやすい点です。

ライセンス

MIT