So verwenden Sie PigeonCast MCP
Diese Anleitung beschreibt ausführlich die Einrichtung von PigeonCast MCP, mit dem Ihre KI die Bildschirmspiegelung steuern kann.
Step-by-Step Guide
Allgemeine Einrichtungsanleitung
- Notieren Sie den MCP-Pfad. Bei Installationen von der offiziellen Website lautet der Standardpfad C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe; bei der Microsoft-Store-Version ist es die im App-Paket enthaltene Datei Tools\pigeoncast-mcp.exe. Sie können im Installationsverzeichnis nach diesem Dateinamen suchen. a. Wenn Sie bei der Installation von der offiziellen Website Add to PATH aktiviert haben, können Sie pigeoncast-cli ping direkt im Terminal ausführen. Für die MCP-Konfiguration empfiehlt sich dennoch der vollständige Pfad zu pigeoncast-mcp.exe, damit der KI-Client das Programm immer findet.
- Ändern Sie den Wert command im folgenden JSON in den tatsächlichen Pfad von pigeoncast-mcp.exe auf Ihrem Computer. Beachten Sie, dass umgekehrte Schrägstriche in JSON als \ geschrieben werden müssen. Kopieren Sie das JSON mit dem korrigierten Pfad in das KI-Chatfenster und weisen Sie die KI an: Global anwenden.
- Laden Sie MCP nach dem Speichern der Konfiguration im jeweiligen Client neu oder starten Sie die Anwendung neu. Anschließend sollten in der Werkzeugliste Namen erscheinen, die mit host_ beginnen, etwa host_ping, host_discovery_list_devices und host_mirror_start.
- Schneller Selbsttest: Weisen Sie die KI an: "Prüfe mit PigeonCasts host_ping, ob die Anwendung ausgeführt wird." Wenn das Hauptprogramm bereits läuft, sollte eine Erfolgsmeldung zurückgegeben werden; andernfalls wird gemeldet, dass die Pipe-Verbindung fehlgeschlagen ist.
Cursor
Option A: Nur aktuelles Projekt (für die gemeinsame Nutzung im Team empfohlen)
- Erstellen Sie im Projektstamm die Datei .cursor/mcp.json.
- Fügen Sie die mcpServers-Konfiguration aus dem vorherigen Abschnitt ein und setzen Sie command auf den absoluten Pfad von pigeoncast-mcp.exe auf dem lokalen Computer.
- Öffnen Sie Cursor → Einstellungen → MCP, prüfen Sie, ob der Server pigeoncast angezeigt wird, und klicken Sie dann auf Neu laden beziehungsweise aktualisieren Sie die Ansicht.
Option B: Für alle Projekte verfügbar
- Öffnen Sie Cursor → Einstellungen → MCP → Neuen globalen MCP-Server hinzufügen.
- Wählen Sie stdio als Typ, geben Sie den vollständigen Pfad von pigeoncast-mcp.exe als Befehl ein und lassen Sie die Argumente leer. Alternativ können Sie die benutzerspezifische Konfigurationsdatei manuell bearbeiten. Ihr Speicherort hängt von der Version ab; häufig lautet er %USERPROFILE%.cursor\mcp.json. Verwenden Sie dasselbe Format wie im vorherigen Abschnitt.
Tipps
- Stellen Sie sicher, dass die PigeonCast-Hauptanwendung läuft, bevor Sie den Agenten nach Geräten suchen oder eine Bildschirmübertragung starten lassen.
- Falls Cursor noch einen alten MCP-Prozess verwendet, laden Sie MCP nach der Konfigurationsänderung neu. Beenden Sie Cursor vollständig und öffnen Sie es erneut, falls das Problem fortbesteht.
- Ausführliche Werkzeugbeschreibungen und Testszenarien finden Sie in der Datei mcp-usage-for-testers.md im Repository.
Claude Code (CLI)
Option A: Über die Befehlszeile hinzufügen (empfohlen)
Führen Sie den folgenden Befehl in PowerShell aus und ersetzen Sie den Pfad durch Ihren Installationspfad:claude mcp add --scope user pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe" Wenn der Server nur für das aktuelle Projekt verfügbar sein soll:
claude mcp add --scope project pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
So prüfen Sie, ob er erfolgreich hinzugefügt wurde:
claude mcp list
Option B: Konfigurationsdatei bearbeiten
| Gültigkeitsbereich | Konfigurationsdatei |
|---|---|
| Aktuelles Projekt | .mcp.json im Projektstamm |
| Alle Projekte auf diesem Computer | mcpServers in %USERPROFILE%\.claude.json |
Beispiel für .mcp.json:
{
"mcpServers": {
"pigeoncast": {
"type": "stdio",
"command": "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe",
"args": []
}
}
}
Starten Sie nach dem Speichern die Claude-Code-Sitzung neu oder führen Sie – je nach aktueller Version – innerhalb der Sitzung den Befehl zum Neuladen von MCP aus.
Claude Desktop (Windows)
- Beenden Sie Claude Desktop vollständig, einschließlich des Prozesses im Infobereich.
- Bearbeiten Sie die Konfigurationsdatei. Verwenden Sie bei einer MSIX-Installation den unten unter Tatsächlich von der App gelesen angegebenen Pfad, anstatt nur die über Konfiguration bearbeiten geöffnete Datei zu bearbeiten; andernfalls wird die Änderung möglicherweise nicht wirksam.
- Fügen Sie auf der obersten Ebene der JSON-Datei mcpServers mit derselben Struktur wie in Abschnitt 2 hinzu oder führen Sie den vorhandenen Eintrag zusammen. Setzen Sie command auf den absoluten Pfad von pigeoncast-mcp.exe.
- Speichern Sie die Datei und starten Sie Claude Desktop neu.
- Prüfen Sie unter Einstellungen → Entwickler, ob pigeoncast in der Liste der MCP-Server angezeigt wird.
OpenAI Codex (CLI)
Codex verwendet TOML zur Konfiguration von MCP. Die Standarddatei ist %USERPROFILE%.codex\config.toml. Auf Projektebene können Sie .codex/config.toml im Stammverzeichnis eines vertrauenswürdigen Repositorys verwenden.
Option A: Über die Befehlszeile hinzufügen
codex mcp add pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
So zeigen Sie die aktuelle Konfiguration an:
codex mcp list
Option B: config.toml bearbeiten
Fügen Sie Folgendes zu ~/.codex/config.toml hinzu:
[mcp_servers.pigeoncast]
command = "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
args = []
enabled = true
Wenn Sie eine projektspezifische .codex/config.toml verwenden, müssen Sie das Projekt als Trusted markieren; andernfalls wird der lokale MCP-Server möglicherweise nicht geladen. Dokumentation: Codex MCP Servers (halten Sie sich im Zweifelsfall an die aktuelle OpenAI-Dokumentation)
Andere MCP-kompatible Clients
Jeder Client, der stdio-basiertes MCP unterstützt und die Angabe eines ausführbaren Pfads samt Argumenten ermöglicht, kann dieselbe Grundkonfiguration verwenden:
- command: der absolute Pfad zu pigeoncast-mcp.exe
- args: [] (leer lassen)
- env: In der Regel sind keine zusätzlichen Umgebungsvariablen erforderlich. Übernehmen Sie den mcpServers-Block aus Abschnitt 2 und passen Sie Dateiname und Feldnamen an den Ziel-Client an. Einige Clients verwenden Felder wie type: "stdio".