Schritt-fuer-Schritt-Anleitung (ANLEITUNG.md) fuer Einrichtung und Nutzung
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NaZBZofC1on2gkSMb5UWZy
This commit is contained in:
Claude
parent
9604e26351
commit
694ae03b49
1 changed files with 258 additions and 0 deletions
258
ANLEITUNG.md
Normal file
258
ANLEITUNG.md
Normal file
|
|
@ -0,0 +1,258 @@
|
||||||
|
# Anleitung: StarCraft-Kampagnen-MCP-Server einrichten & benutzen
|
||||||
|
|
||||||
|
Diese Anleitung ist für **null Programmierkenntnisse** gedacht. Du tippst nur die
|
||||||
|
fettgedruckten Befehle ab. Wenn etwas von *deinem* Setup abhängt, steht ausdrücklich
|
||||||
|
dabei „**das musst du anpassen**".
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. Was du brauchst (Checkliste)
|
||||||
|
|
||||||
|
- [ ] **Zugang zu deinem Hetzner-VPS** (per SSH – also das schwarze Terminal-Fenster,
|
||||||
|
mit dem du dich auf den Server einloggst).
|
||||||
|
- [ ] Auf dem VPS sind **Docker** und **Caddy** installiert und laufen bereits
|
||||||
|
(hast du). Caddy ist dein „Türsteher", der die Webadresse + das Sicherheitsschloss
|
||||||
|
(TLS/https) bereitstellt.
|
||||||
|
- [ ] Eine **Subdomain**, z.B. `sc-mcp.pixel-by-design.de`, deren DNS-Eintrag auf die
|
||||||
|
IP-Adresse deines VPS zeigt. (Einstellung beim Anbieter, wo deine Domain liegt.)
|
||||||
|
- [ ] Ein **Claude-Bezahl-Account** (Pro, Max, Team oder Enterprise). Nur diese können
|
||||||
|
eigene „Custom Connectors" hinzufügen – im Gratis-Account fehlt die Funktion.
|
||||||
|
- [ ] **Basis-Karten** (`.scx`/`.scm`) und optionale **WAV-Sounddateien**, aus denen
|
||||||
|
Claude Missionen bauen soll. Eine Beispiel-Karte liegt schon dabei.
|
||||||
|
|
||||||
|
> **Begriffe in einem Satz:**
|
||||||
|
> *MCP-Server* = das Programm, das Karten lesen/schreiben kann.
|
||||||
|
> *Connector* = die Verbindung, über die Claude dieses Programm benutzt.
|
||||||
|
> *Docker* = verpackt das Programm so, dass es überall gleich startet.
|
||||||
|
> *Caddy* = stellt die https-Webadresse bereit.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Teil A — Einmalig einrichten (ca. 15 Minuten)
|
||||||
|
|
||||||
|
### A1. Auf den Server einloggen
|
||||||
|
|
||||||
|
Öffne ein Terminal auf deinem Computer und logge dich auf dem VPS ein (Adresse/Benutzer
|
||||||
|
hast du von Hetzner):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ssh dein-benutzer@deine-server-ip
|
||||||
|
```
|
||||||
|
|
||||||
|
Alle weiteren Befehle tippst du **auf dem Server** (im eingeloggten Fenster).
|
||||||
|
|
||||||
|
### A2. Das Projekt auf den Server holen
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/Kenearos/Star-Edit.git
|
||||||
|
cd Star-Edit
|
||||||
|
```
|
||||||
|
|
||||||
|
Falls du das Projekt schon mal geholt hast, hol nur die neueste Version:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd Star-Edit
|
||||||
|
git pull origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
### A3. Das Docker-Netzwerk von Caddy herausfinden — **das musst du anpassen**
|
||||||
|
|
||||||
|
Damit Caddy mit unserem Server reden kann, müssen beide im selben Docker-Netzwerk sein.
|
||||||
|
Zeig dir die vorhandenen Netzwerke an:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker network ls
|
||||||
|
```
|
||||||
|
|
||||||
|
Suche den Namen, den **dein Caddy** benutzt (oft `caddy`, manchmal `web`, `proxy` o.ä.).
|
||||||
|
Trage diesen Namen in die Datei `docker-compose.yml` ein – ganz unten steht:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
networks:
|
||||||
|
web:
|
||||||
|
external: true
|
||||||
|
name: caddy # <-- hier den echten Netzwerknamen eintragen
|
||||||
|
```
|
||||||
|
|
||||||
|
Bearbeiten kannst du die Datei z.B. mit dem Editor `nano`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nano docker-compose.yml
|
||||||
|
```
|
||||||
|
|
||||||
|
(Ändern, dann mit `Strg+O`, `Enter` speichern und `Strg+X` schließen.)
|
||||||
|
|
||||||
|
> Wenn du dir unsicher bist, welches Netzwerk Caddy nutzt:
|
||||||
|
> `docker inspect <caddy-container-name> | grep -i network` zeigt es an.
|
||||||
|
|
||||||
|
### A4. Subdomain auf den Server zeigen lassen (DNS) — **das musst du anpassen**
|
||||||
|
|
||||||
|
Beim Anbieter deiner Domain legst du einen **A-Record** an:
|
||||||
|
|
||||||
|
| Typ | Name (Host) | Wert (Ziel) |
|
||||||
|
|-----|-------------|-------------|
|
||||||
|
| A | `sc-mcp` | *die IP-Adresse deines VPS* |
|
||||||
|
|
||||||
|
Damit wird `sc-mcp.pixel-by-design.de` auf deinen Server gezeigt. (Kann ein paar Minuten
|
||||||
|
bis Stunden dauern, bis es überall aktiv ist.)
|
||||||
|
|
||||||
|
### A5. Caddy für die Subdomain konfigurieren
|
||||||
|
|
||||||
|
Öffne deine bestehende Caddy-Konfiguration (deine `Caddyfile`) und füge diesen Block
|
||||||
|
hinzu – er steht auch in der mitgelieferten Datei [`Caddyfile`](./Caddyfile):
|
||||||
|
|
||||||
|
```caddy
|
||||||
|
sc-mcp.pixel-by-design.de {
|
||||||
|
reverse_proxy sc-mcp:8000
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Das heißt: „Alles, was an `sc-mcp.pixel-by-design.de` ankommt, leite an unseren Server
|
||||||
|
weiter." Caddy holt das https-Zertifikat automatisch.
|
||||||
|
|
||||||
|
Danach Caddy neu laden (je nach deinem Setup einer dieser Befehle):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker exec -w /etc/caddy <caddy-container-name> caddy reload
|
||||||
|
# oder, falls Caddy nicht in Docker läuft:
|
||||||
|
sudo systemctl reload caddy
|
||||||
|
```
|
||||||
|
|
||||||
|
> Falls du die Subdomain im selben Reverse-Proxy noch nicht hattest: `<caddy-container-name>`
|
||||||
|
> findest du mit `docker ps` (Spalte NAMES).
|
||||||
|
|
||||||
|
### A6. Den Server starten (der eine Befehl)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./run.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
Das baut beim ersten Mal das Programm (dauert 1–2 Minuten) und startet es. Fertig sieht
|
||||||
|
so aus, dass kein Fehler erscheint und der Server läuft.
|
||||||
|
|
||||||
|
Prüfen, ob er läuft:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./run.sh logs
|
||||||
|
```
|
||||||
|
|
||||||
|
(Mit `Strg+C` schließt du die Log-Ansicht wieder – der Server läuft weiter.)
|
||||||
|
|
||||||
|
**Schnelltest, ob alles greift** (baut testweise eine Mini-Mission):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./run.sh selftest
|
||||||
|
```
|
||||||
|
|
||||||
|
Wenn am Ende **„SELBSTTEST BESTANDEN"** steht, ist das Fundament in Ordnung.
|
||||||
|
|
||||||
|
### A7. In Claude als Connector eintragen
|
||||||
|
|
||||||
|
1. Claude öffnen (Web oder App) → **Einstellungen** → **Connectors** (bzw.
|
||||||
|
„Connectors verwalten").
|
||||||
|
2. **Custom Connector hinzufügen** wählen.
|
||||||
|
3. Als Adresse/URL eintragen:
|
||||||
|
|
||||||
|
```
|
||||||
|
https://sc-mcp.pixel-by-design.de/mcp
|
||||||
|
```
|
||||||
|
|
||||||
|
(Wichtig: das `/mcp` am Ende gehört dazu.)
|
||||||
|
4. Speichern. Ab jetzt darf Claude im Chat die `sc_`-Werkzeuge benutzen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Teil B — Eine Mission bauen (so läuft es im Alltag)
|
||||||
|
|
||||||
|
### B1. Karten & Sounds bereitstellen
|
||||||
|
|
||||||
|
Lege deine Dateien auf dem Server in den Ordner `Star-Edit/data/maps/`:
|
||||||
|
|
||||||
|
- Basis-Karten: `.scx` oder `.scm`
|
||||||
|
- Sounds/Voiceover: `.wav`
|
||||||
|
|
||||||
|
Hochladen z.B. vom eigenen Rechner aus (in einem **neuen** Terminal, *nicht* eingeloggt
|
||||||
|
auf dem Server):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scp meine-karte.scx funk1.wav dein-benutzer@deine-server-ip:~/Star-Edit/data/maps/
|
||||||
|
```
|
||||||
|
|
||||||
|
Eine Beispiel-Karte (`base-map.scx`) liegt bereits drin – du kannst sofort loslegen.
|
||||||
|
|
||||||
|
### B2. Mit Claude im Chat arbeiten
|
||||||
|
|
||||||
|
Schreib Claude einfach, was du willst – auf Deutsch. Claude ruft dann selbst die
|
||||||
|
Werkzeuge auf. Beispiele:
|
||||||
|
|
||||||
|
> „Zeig mir die vorhandenen Karten."
|
||||||
|
> → Claude nutzt `sc_list_maps`.
|
||||||
|
|
||||||
|
> „Beschreib mir die Karte `base-map.scx`."
|
||||||
|
> → Claude nutzt `sc_describe_map` (Größe, Spieler, Locations, Trigger).
|
||||||
|
|
||||||
|
> „Erstelle auf `base-map.scx` bei Spielstart eine Texteinblendung ‚Mission 1 – Start'
|
||||||
|
> und spawne 4 Marines für Spieler 1 an einer neuen Location ‚Basis' in der Kartenmitte.
|
||||||
|
> Speichere das Ergebnis als `mission1.scx`."
|
||||||
|
> → Claude legt die Location an (`sc_create_location`), baut den Trigger
|
||||||
|
> (`sc_add_trigger`) und speichert (`sc_save_map`).
|
||||||
|
|
||||||
|
Für **Voiceover/Funksprüche**:
|
||||||
|
|
||||||
|
> „Bette `funk1.wav` ein und spiel es bei Sekunde 30 zusammen mit dem Text
|
||||||
|
> ‚Achtung, Feindkontakt!' ab."
|
||||||
|
> → Claude nutzt `sc_embed_wav` + `sc_add_trigger` (play_wav + display_text).
|
||||||
|
|
||||||
|
### B3. Ergebnis abholen
|
||||||
|
|
||||||
|
Die fertige Mission liegt danach in `Star-Edit/data/maps/` (z.B. `mission1.scx`). Auf den
|
||||||
|
eigenen Rechner herunterladen:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scp dein-benutzer@deine-server-ip:~/Star-Edit/data/maps/mission1.scx .
|
||||||
|
```
|
||||||
|
|
||||||
|
Diese Datei kannst du in StarCraft laden und spielen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Teil C — Befehls-Spickzettel (auf dem Server, im Ordner `Star-Edit`)
|
||||||
|
|
||||||
|
| Was du willst | Befehl |
|
||||||
|
|---------------|--------|
|
||||||
|
| Server starten / neu starten | `./run.sh` |
|
||||||
|
| Logs ansehen (beenden mit Strg+C) | `./run.sh logs` |
|
||||||
|
| Selbsttest laufen lassen | `./run.sh selftest` |
|
||||||
|
| Server stoppen | `./run.sh stop` |
|
||||||
|
| Neueste Programmversion holen | `git pull origin main` danach `./run.sh` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Teil D — Wenn etwas klemmt
|
||||||
|
|
||||||
|
- **Claude sagt, der Connector ist nicht erreichbar.**
|
||||||
|
1. Läuft der Server? `./run.sh logs` ansehen.
|
||||||
|
2. Zeigt die Subdomain schon auf den Server? Im Browser `https://sc-mcp.pixel-by-design.de/mcp`
|
||||||
|
öffnen – kommt *irgendeine* Antwort (kein „Server nicht gefunden"), passt das Grundsätzliche.
|
||||||
|
3. Sind Caddy und der `sc-mcp`-Container im **selben** Docker-Netzwerk (Schritt A3)?
|
||||||
|
|
||||||
|
- **„network caddy not found" o.ä. beim Start.**
|
||||||
|
Der Netzwerkname in `docker-compose.yml` stimmt nicht mit deinem Caddy-Netzwerk
|
||||||
|
überein → Schritt A3 wiederholen (`docker network ls`).
|
||||||
|
|
||||||
|
- **Claude findet eine Location/Einheit nicht.**
|
||||||
|
Die Fehlermeldung listet die verfügbaren Namen auf – einfach einen davon nehmen oder
|
||||||
|
die Location vorher anlegen lassen.
|
||||||
|
|
||||||
|
- **Ich will den Server ohne Caddy nur kurz lokal testen.**
|
||||||
|
In `docker-compose.yml` die zwei `ports:`-Zeilen einkommentieren (`# ports:` und
|
||||||
|
`# - "8000:8000"`), dann `./run.sh`. Endpunkt: `http://deine-server-ip:8000/mcp`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Sicherheitshinweis
|
||||||
|
|
||||||
|
Der Server hat **kein Passwort**: Wer die URL `https://sc-mcp.pixel-by-design.de/mcp`
|
||||||
|
kennt, kann ihn benutzen. Für ein privates Werkzeug ist das meist okay – halte die URL
|
||||||
|
aber für dich. Wenn du später einen Zugriffsschutz möchtest, sag Bescheid, dann bauen wir
|
||||||
|
einen (z.B. ein Token in Caddy) ein.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue