@aiondadotcom/mcp-openai-image/CLAUDE.md

MCP server for OpenAI image generation with STDIO transport

# MCP OpenAI Image Server

## Projektbeschreibung
Dieses Projekt implementiert einen MCP (Model Context Protocol) Server für die OpenAI Bildgenerierung. Der Server ermöglicht es, über eine standardisierte Schnittstelle Bilder mit DALL-E zu generieren, zu bearbeiten und zu streamen.

## Entwicklungsumgebung einrichten

### Abhängigkeiten installieren
```bash
npm install
```

### TypeScript kompilieren
```bash
npm run build
```

### Entwicklungsserver starten
```bash
npm run dev
```

### Tests ausführen
```bash
npm test
```

### Test-Coverage erstellen
```bash
npm run test:coverage
```

## API-Konfiguration

### OpenAI API-Schlüssel konfigurieren
Die API-Konfiguration wird automatisch in `~/.mcp-openai-image.json` im Home-Verzeichnis des Benutzers gespeichert. Diese Datei ist benutzer-spezifisch und wird nicht mit dem Projekt versioniert.

**Wichtig:** Sowohl der API-Schlüssel als auch die Organisations-ID sind für die Bildgenerierung erforderlich. Die Organisations-ID muss beim Konfigurieren des Servers angegeben werden.

### Standard-Modell
Das Projekt verwendet standardmäßig `gpt-4.1` für die Bildgenerierung, da dieses Modell bessere Ergebnisse liefert.

## Verfügbare Tools

1. **generate-image**: Generiert Bilder mit verschiedenen Parametern
2. **configure-server**: Konfiguriert OpenAI API-Schlüssel und Einstellungen
3. **edit-image**: Bearbeitet bestehende Bilder
4. **stream-image**: Generiert Bilder mit Streaming-Funktionalität
5. **get-config-status**: Überprüft den Konfigurationsstatus
6. **list-supported-models**: Listet unterstützte Modelle auf

## Unterstützte Parameter

- **Größen**: 1024x1024, 1024x1536, 1536x1024
- **Qualität**: standard, hd
- **Formate**: png, jpeg, webp
- **Hintergrund**: transparent, opaque, auto

## Fehlerbehebung

### Häufige Probleme
- **API-Schlüssel nicht konfiguriert**: Verwenden Sie `configure-server` Tool
- **Unbekannte Parameter**: Überprüfen Sie die unterstützten Parameter
- **Organisationsverifizierung**: Stellen Sie sicher, dass Ihre OpenAI-Organisation verifiziert ist

### Logging
Der Server protokolliert wichtige Ereignisse in der Konsole. Überprüfen Sie die Ausgabe auf Fehler oder Warnungen.

### Dateien auf dem Desktop
Der Server speichert nur Bilddateien auf dem Desktop. Metadaten werden ausschließlich in der MCP-Response zurückgegeben und nicht als separate JSON-Dateien gespeichert.

## Sicherheit

- API-Schlüssel werden lokal in `~/.mcp-openai-image.json` im Home-Verzeichnis gespeichert
- Diese Datei ist benutzer-spezifisch und wird nicht mit dem Projekt versioniert
- Verwenden Sie niemals API-Schlüssel direkt im Code

## Deployment

### Produktionsserver starten
```bash
npm run build
npm start
```

### Als MCP-Server verwenden
Der Server kann als MCP-Server in kompatiblen Anwendungen verwendet werden.

## Desktop Extension (DXT) Release erstellen

Dieses Projekt unterstützt das Anthropic Desktop Extension Format (.dxt), das eine Ein-Klick-Installation in Claude Desktop ermöglicht.

### Voraussetzungen
- DXT Tool installiert: `npm install -g @anthropic-ai/dxt`
- Projekt muss kompiliert sein

### DXT Release erstellen

1. **Code kompilieren**
   ```bash
   npm run build
   ```

2. **DXT Paket erstellen**
   ```bash
   dxt pack
   ```

Das Tool erstellt automatisch eine `.dxt` Datei (z.B. `mcp-openai-image-1.0.2.dxt`) mit:
- Kompiliertem TypeScript Code (`build/` Verzeichnis)
- Allen Abhängigkeiten (`node_modules/`)
- Manifest-Datei (`manifest.json`)
- Dokumentation und Konfigurationsdateien

### Installation der DXT-Datei
1. `.dxt` Datei herunterladen
2. Doppelklick zum Öffnen mit Claude Desktop
3. "Install" klicken

Keine weitere Konfiguration erforderlich - alle Abhängigkeiten sind bereits im Paket enthalten.