snip-mcp

Ein MCP-Server, mit dem Sie Bildschirmbereiche direkt in Ihre Claude Code-Konversationen aufnehmen können. Wählen Sie einen beliebigen Bereich Ihres Bildschirms über einen Hotkey oder Tool-Aufruf aus, und der Screenshot ist sofort als Bild im Kontext verfügbar.

Funktionen

• Hotkey-Aufnahme -- Strg+Umschalt+Klick öffnet ein Snipping-Overlay überall und jederzeit

• Tool-gesteuerte Aufnahme -- Claude kann das Snipping-Tool in Ihrem Namen aufrufen

• Multi-Monitor-Unterstützung -- funktioniert auf allen angeschlossenen Bildschirmen mit DPI-Unterstützung

• Persistenter Speicher -- Snips werden auf der Festplatte gespeichert und überstehen Server-Neustarts

• Automatische Bereinigung -- konfigurierbares Limit verhindert unbegrenztes Speicherwachstum

• Toast-Benachrichtigungen -- visuelle Bestätigung, wenn ein Snip aufgenommen wurde

Related MCP server: Shotik

Anforderungen

• Windows 10 oder höher (verwendet Windows-spezifische globale Maus-Hooks via ctypes)

• Python 3.11+

Installation

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

Oder mit uv:

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

Claude Code Konfiguration

Fügen Sie den Server zu Ihren Claude Code MCP-Einstellungen hinzu.

Bei Installation via pip (global oder venv)

In ~/.claude/settings.json (global) oder .claude/settings.json (Projekt):

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

Bei Verwendung von uv (empfohlen für Isolation)

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

Verwendung

Hotkey-Aufnahme

Drücken Sie Strg+Umschalt+Linksklick an einer beliebigen Stelle auf dem Bildschirm, um das Snipping-Overlay zu öffnen:

1. Klicken und ziehen, um einen Bereich auszuwählen

2. Loslassen, um aufzunehmen

3. Drücken Sie Escape, um abzubrechen

Eine Toast-Benachrichtigung bestätigt die Aufnahme.

Tool-gesteuerte Aufnahme

Bitten Sie Claude, einen Screenshot zu machen -- es wird das snip_screen-Tool aufrufen und das Overlay für Sie öffnen.

Snips verwalten

Diese MCP-Tools stehen Claude zur Verfügung:

Konfiguration

Die Konfiguration wird unter ~/.snip_mcp/config.json gespeichert und beim ersten Start automatisch erstellt.

Beispiel-Konfiguration:

{
  "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
}

Fehlerbehebung

"snip-mcp requires Windows" Dieser Server verwendet Windows-spezifische APIs (globale Maus-Hooks via ctypes). Er kann nicht unter macOS oder Linux ausgeführt werden.

"Failed to install mouse hook" Der globale Maus-Hook erfordert möglicherweise erhöhte Berechtigungen. Versuchen Sie, Ihr Terminal als Administrator auszuführen.

Overlay erscheint nicht Stellen Sie sicher, dass keine andere Anwendung Strg+Umschalt+Klick abfängt. Überprüfen Sie modifier_keys in Ihrer Konfiguration.

Koordinaten sind auf High-DPI-Bildschirmen verschoben Der Server ruft beim Start SetProcessDPIAware() auf. Wenn Sie weiterhin Versatzprobleme sehen, überprüfen Sie Ihre Windows-Anzeigeskalierungseinstellungen.

Snips-Verzeichnis Standardmäßig werden Snips unter ~/.snip_mcp/snips/ gespeichert. Sie können dies in der config.json ändern.

Lizenz

MIT -- siehe LICENSE für Details.