# 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.

```powershell
# 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:**
  ```powershell
  mcp-server-windows-launcher
  ```
   
2. **Als Python-Modul:**
  ```powershell
  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:

```json
{
  "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:

```json
{
  "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

```python
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:
```powershell
git clone https://github.com/username/mcp-server-windows-launcher.git
cd mcp-server-windows-launcher
```

2. Python-Umgebung einrichten (Python 3.9+):
```powershell
python -m pip install --upgrade pip
pip install -e .
```

3. Entwicklungsabhängigkeiten installieren:
```powershell
pip install pytest pytest-asyncio black flake8
```

### Tests

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

```powershell
# 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:

```powershell
# 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

```powershell
# 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 [LICENSE](LICENSE) Datei für Details.

## 📝 Verfügbare Tools

### open_in_edge

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

### open_with_default_app

```json
{
  "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`)