winuse-mcp

Computerbenutzung für Claude Code unter Windows. Ein MCP-Server, der Claude ermöglicht, Ihren Bildschirm zu sehen und Maus und Tastatur zu steuern.

Claude Code liefert die Computerbenutzung in der CLI nur für macOS; daher erscheint der Server computer-use unter Windows nie in /mcp. Dieser Server baut denselben Screenshot-und-Klick-Kreislauf auf Windows-APIs nach: 14 Tools, 5 Abhängigkeiten, Python 3.12.

Installation

Benötigt Windows und uv. Fügen Sie dies in einem Projekt zu .mcp.json oder für jedes Projekt zu ~/.claude.json hinzu:

{
  "mcpServers": {
    "winuse": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ryanportfolio/winuse-mcp", "winuse-mcp"]
    }
  }
}

Stattdessen von einem lokalen Klon:

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

Starten Sie Claude Code neu und bitten Sie es, Ihren Bildschirm anzusehen oder durch eine App zu klicken.

Related MCP server: Win:Computer Use

Reichweite

Koordinaten beziehen sich immer auf den Screenshot-Raum. Siehe unten.

Wie Koordinaten funktionieren

Screenshots werden herunterskaliert, sodass die lange Seite maximal 1372 Pixel beträgt – dasselbe Ziel, das Claude Code unter macOS verwendet. Claude sieht nie native Pixel, daher klickt es im herunterskalierten Bild und der Server rechnet zurück.

Ein 1920x1080-Display erfasst bei 1372x772, einem Faktor von 0,715. Ein Klick bei 686,443 landet bei 960,620.

Der Server deklariert sich beim Start als DPI-fähig, sodass die Windows-Display-Skalierung bei 125% oder 150% die Klickposition nicht verfälscht.

Sicherheit

Hiermit wird einem Sprachmodell die Kontrolle über Ihren Desktop übergeben. Anthropics eigene Version umgibt denselben Kreislauf mit Schutzmaßnahmen, die dieser Server nicht hat: app-spezifische Genehmigung, Ausblenden von Apps, für die Claude nicht freigegeben wurde, Ihr Terminal aus den Screenshots heraushalten sowie modellseitige Überprüfungen jeder Aktion.

Was Sie erhalten:

• Claude Code fragt vor jedem Tool-Aufruf nach, es sei denn, Sie setzen es auf die Whitelist. Belassen Sie die Eingabe-Tools auf manueller Genehmigung und setzen Sie nur screenshot auf die Whitelist.

• Parken Sie die Maus in der oberen linken Ecke des Bildschirms, um die laufende Aktion abzubrechen. Dies ist pyautoguis Failsafe, und es überwacht nur diese eine Ecke. Ein Abbruch während eines Ziehvorgangs löst die Maustaste beim Verlassen, sodass nichts mehr zieht.

• Alles Sichtbare erreicht das Modell, einschließlich dessen, was gerade auf dem Bildschirm ist. Text auf dem Bildschirm ist nicht vertrauenswürdige Eingabe: Behandeln Sie Anweisungen, die dort erscheinen, als Risiko eines Prompt-Injection-Angriffs.

Einschränkungen

• Nur primärer Monitor.

• Ihr Terminal wird nicht von Screenshots ausgeschlossen, sodass Claude seine eigene Sitzung sieht.

• record nimmt Einzelbilder auf, maximal 8 davon. Es gibt keinen Videopfad.

Entwicklung

uv sync
uv run winuse-mcp

scripts/client_test.py ist die Referenzprüfung: Es kommuniziert über MCP per stdio mit dem Server, listet die Tools auf, macht einen Screenshot, bewegt die Maus und liest die Position zurück, nimmt Bilder auf und bestätigt, dass eine ungültige Tastenkombination einen Fehler ausgibt.

uv run python scripts/client_test.py

scripts/failsafe_test.py deckt die Pfade ab, die ein Benutzer beim Abbruch trifft, wobei pyautogui gestubbt ist, sodass kein echter Abbruch nötig ist: Ein abgebrochener Ziehvorgang gibt dennoch die Taste frei, ein abgebrochenes horizontales Scrollen gibt dennoch die Umschalttaste frei, die Akkordanalyse behandelt ein wörtliches +, und kein Klick kann auf das Failsafe-Pixel fallen.

uv run python scripts/failsafe_test.py

Diese README wird erstellt. Jede Zahl auf der Seite wird zur Erstellungszeit aus der Quelle neu berechnet, und die Erstellung schlägt fehl, wenn eine abweicht.

node scripts/readme/build.mjs

Lizenz

MIT