lka/mcp_server_windows_launcher

MCP Server Windows Launcher

Ein Model Context Protocol (MCP) Server-Plugin zum Öffnen von Dateien in Windows-Anwendungen.

🎯 Funktionen

• open_in_edge: Öffnet eine oder mehrere Dateien im Microsoft Edge Browser (optional in neuen Fenstern)
• open_with_default_app: Öffnet eine Datei mit der Windows-Standard-Anwendung
• Unterstützung für absolute und relative Pfade
• Asynchrone Ausführung
• Ausführliche Fehlerbehandlung und Statusmeldungen

📦 Installation

Python-Abhängigkeiten

Das Paket erfordert Python 3.9 oder höher und läuft nur unter Windows.

# Mit pip installieren (von PyPI, sobald veröffentlicht)
pip install mcp-server-windows-launcher

# Oder direkt aus dem Repository (Entwicklungsversion)
pip install git+https://github.com/username/mcp-server-windows-launcher.git

Verwendung

Nach der Installation können Sie den Server auf zwei Arten starten:

1. Direkt über die Kommandozeile:

mcp-server-windows-launcher

2. Als Python-Modul:

python -m mcp_server_windows_launcher.server

Claude Desktop Konfiguration

1. Öffnen Sie die Claude Desktop Konfigurationsdatei:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie den Windows-Launcher Server hinzu:

{
  "mcpServers": {
    "windows-launcher": {
      "command": "mcp-server-windows-launcher"
    }
  }
}

Wichtig: Wenn Sie bereits andere MCP-Server konfiguriert haben, fügen Sie den neuen Server einfach zur Liste hinzu:

{
  "mcpServers": {
    "image-selector": { ... },
    "tesseract": { ... },
    "filesystem": { ... },
    "windows-launcher": {
      "command": "python",
      "args": ["-m", "mcp_server_windows_launcher.server"]
    }
  }
}

Claude Desktop neu starten

Nach der Konfiguration müssen Sie Claude Desktop komplett schließen und neu starten.

🚀 Verwendung

1. In Claude Desktop

Nach der Installation können Sie Claude bitten:

• "Öffne die Datei XYZ im Edge Browser"
• "Starte Edge mit diesen beiden HTML-Dateien"
• "Öffne die PDF mit der Standard-App"

2. Als Python-Paket

from mcp_server_windows_launcher.server import open_in_edge, open_with_default_app

# Dateien in Edge öffnen
results = await open_in_edge(
    ["datei1.html", "datei2.pdf"],
    new_window=True  # Optional: In neuen Fenstern öffnen
)

# Datei mit Standard-App öffnen
result = await open_with_default_app("dokument.pdf")

👩‍💻 Entwicklung

Entwicklungsumgebung einrichten

1. Repository klonen:

git clone https://github.com/username/mcp-server-windows-launcher.git
cd mcp-server-windows-launcher

2. Python-Umgebung einrichten (Python 3.9+):

python -m pip install --upgrade pip
pip install -e .

3. Entwicklungsabhängigkeiten installieren:

pip install pytest pytest-asyncio black flake8

Tests

Vor dem Ausführen der Tests muss das Paket in editierbarem Modus installiert sein:

# Paket installieren (nur einmal notwendig)
python -m pip install -e .

# Alternativ: PYTHONPATH setzen (bei jedem neuen Terminal notwendig)
$env:PYTHONPATH='src'

Dann können die Tests ausgeführt werden:

# Alle Tests ausführen
pytest tests/

# Tests mit detaillierter Ausgabe
pytest -v tests/

# Tests mit Ausgabe der Testabdeckung
pytest --cov=src/mcp_server_windows_launcher tests/

Code-Qualität

# Code formatieren (Black)
black src/ tests/

# Linting (Flake8)
flake8 src/ tests/

Continuous Integration

Das Projekt verwendet GitHub Actions für:

• Automatische Tests auf Windows
• Tests mit Python 3.9 bis 3.13
• Ausführung bei Push und Pull Requests
• Code-Qualitätsprüfung

Die Konfiguration befindet sich in .github/workflows/python-tests.yml

📄 Lizenz

MIT Lizenz - siehe Datei für Details.

📝 Verfügbare Tools

open_in_edge

{
  "file_paths": ["C:\\Pfad\\zur\\Datei.html"],
  "new_window": false
}

open_with_default_app

{
  "file_path": "C:\\Pfad\\zur\\Datei.pdf"
}

🐛 Fehlerbehebung

• "Datei nicht gefunden": Prüfen Sie, ob der Pfad korrekt ist
• Edge startet nicht: Stellen Sie sicher, dass MS Edge installiert ist
• Server läuft nicht: Prüfen Sie, ob mcp installiert ist (pip install mcp)