Entwickler/Änderungsprotokoll

Änderungsprotokoll

Versionen des TypeScript-SDK, des MCP-Servers und der REST-API. Jede SDK- und MCP-Version hat eine feste Download-URL; aktuelle Versionen und Prüfsummen stehen in index.json.

SDK und MCP 0.1.8#

11. Oktober 2026

• SDK: databases.create() kommt mit der ersten Datenbank auf einem Server zurecht, die mit 202 antwortet, während der Datenbankdienst startet (etwa 40 Sekunden). Es gibt ein ausstehendes Ergebnis zurück (prüfe es mit isDatabasePending()), oder übergib { wait: true }, um die fertige Datenbank zu bekommen. databases.waitUntilReady() übernimmt das Warten auch allein. Datenbanken
• SDK: neu sind databases.service(), setRemoteAccess(), export() und import(). Datenbanken melden jetzt remote_ips, remote_anywhere und remote_address.
• MCP: neue Datenbank-Werkzeuge: list_databases, create_database (wartet standardmäßig auf einen neuen Datenbankdienst), set_database_remote_access, rotate_database_password und delete_database. Der selbst betriebene Server hat zusätzlich export_database und import_database. Passwörter bleiben verborgen, außer du fragst danach.

REST-API#

11. Oktober 2026

• Neu: Datenbanken laufen auf dem eigenen Rechner deines Servers. Das erste POST /databases antwortet mit 202 Accepted und dem Status des Datenbankdienstes; die Datenbank erscheint etwa 40 Sekunden später. Details
• Neu: GET /databases/service, POST /databases/{id}/remote (Remote-IPs oder remote_anywhere), GET /databases/{id}/export und POST /databases/{id}/import.
• Änderung: jeder Server enthält 5 Datenbanken. Das Feld remote beim Anlegen wird ignoriert; verwende stattdessen remote_ips.

SDK und MCP 0.1.7#

10. Oktober 2026

• SDK: neue Helfer, die für dich warten: servers.waitForState(), backups.waitUntilDone() und waitForConsole(), das einen Befehl sendet und die passende Antwortzeile liefert.
• SDK: files.upload() und files.download() verarbeiten Binärdateien wie Plugin-JARs und Welt-Archive, und files.exists() prüft einen Pfad.
• SDK: das Lesen einer fehlenden Datei wirft jetzt 404 mit Code NotFound statt des allgemeinen 500 vom Node.
• SDK: users.create() nimmt die öffentliche ID des anderen Kontos (HW-XXXXXX), wie es die API verlangt. Eine E-Mail-Adresse schlägt sofort mit einer klaren Meldung fehl.
• SDK: account.apiKeys.create() liefert jetzt den vollständigen, nutzbaren Schlüssel als token. Vorher war es nur der geheime Teil.
• SDK: klarere Fehler bei einem falschen oder widerrufenen Schlüssel, und Zeitüberschreitungen nennen jetzt den Aufruf. account.updateLanguage() nimmt optional eine Währung.
• Gehosteter MCP: ein Schlüssel, dessen IP-Freigabeliste den gehosteten Server (162.55.180.229) nicht enthält, bekommt jetzt eine Fehlermeldung, die genau das sagt.
• Doku: sie liegt jetzt unter game.hostwolf.net/developers, mit neuen Abschnitten zur IP-Freigabeliste, zu allen Ratenlimits und zur MCP-Fehlerbehebung.

REST-API#

10. Oktober 2026

• Fehlerbehebung: jede ratenbegrenzte Aktion hat jetzt ihren eigenen Zähler. Vorher teilten sie sich einen, sodass ein paar Addon-Suchen den nächsten Versionswechsel oder die nächste Modpack-Installation mit 429 blockieren konnten.
• Fehlerbehebung: POST /game/version mit einer Version, die es nicht gibt, liefert 422 unknown_version. Früher wurde das als Downgrade gemeldet, und mit force hätte es den Server auf diese Version neu installiert.
• Fehlerbehebung: die Installation eines Modpacks oder einer Version, die es nicht gibt, liefert 404 mit einer klaren Meldung statt „Modrinth is not responding“.
• Fehlerbehebung: Avatar-Uploads (POST /account/avatar) funktionieren wieder.

MCP 0.1.6#

7. Oktober 2026

• Gehosteter MCP: Ein widerrufener API-Schlüssel funktioniert jetzt nach spätestens 2 Minuten nicht mehr (vorher 10).
• Gehosteter MCP: Kommen zu viele Anfragen gleichzeitig an, antwortet der Server mit 503 und Retry-After, statt für alle langsamer zu werden.

MCP 0.1.5#

7. Oktober 2026

• Fehlerbehebung: Der selbst betriebene Server startete in 0.1.3 und 0.1.4 nicht über npx. Wenn du eine dieser Versionen nutzt, ändere die Version in deiner Konfiguration auf 0.1.5. Der gehostete Server war nicht betroffen.
• MCP: Der gehostete Modus heißt jetzt hostwolf-mcp --http.

MCP 0.1.4#

7. Oktober 2026

• MCP: Der gehostete Server schreibt nicht mehr für jede Integritätsprüfung eine Logzeile.

Gehosteter MCP und 0.1.3#

7. Oktober 2026

• Neu: der MCP-Server wird unter https://hostwolf.net/mcp gehostet. Verbinde Claude Code, Cursor oder VS Code nur mit der URL und deinem API-Schlüssel; nichts zu installieren, immer aktuell. Einrichtung
• MCP: hostwolf-mcp --http betreibt denselben Server über Streamable HTTP, für alle, die ihn selbst hosten möchten.
• Beispiele in der Dokumentation und READMEs aktualisiert. Der SDK-Code ist unverändert gegenüber 0.1.2.

SDK und MCP 0.1.2#

6. Oktober 2026

• SDK: Ratenlimits mit langem Retry-After (wie 2 Backups pro 10 Minuten) schlagen jetzt sofort fehl, statt zu warten. Die Wartezeit steht in error.retryAfter, und die neue Option maxRetryWaitMs legt fest, wie lange das SDK selbst wartet.
• MCP: Fehler wegen Ratenlimits sagen dem Assistenten, wann er es erneut versuchen kann.

SDK und MCP 0.1.1#

6. Oktober 2026

• SDK: Anfragen mit Zeitüberschreitung werden nicht mehr wiederholt, damit sich bei einem langsamen Endpunkt keine Zeitüberschreitungen aufstapeln. servers.resources() akzeptiert die Option timeoutMs.
• MCP: Live-Statistiken in list_servers und get_server geben nach 5 Sekunden auf, statt hängen zu bleiben, und jedes Werkzeug antwortet innerhalb von 50 Sekunden, bevor KI-Clients abbrechen.
• MCP: neue Werkzeuge delete_backup und delete_schedule.
• MCP: prüft beim Start auf neuere Versionen und erwähnt sie in list_servers.

SDK und MCP 0.1.0#

6. Oktober 2026

• Erste Version des TypeScript-SDK: alle Client-API-Endpunkte, typisierte Antworten, Live-Konsole, Paginierung, Wiederholungen und Fehler.
• Erste Version des MCP-Servers für Claude, Cursor und VS Code.

REST-API#

6. Oktober 2026

• Neu: schreibgeschützte Endpunkte für Tarife und Bestellungen für API-Schlüssel: GET /store/catalog, /store/orders und /store/billing. Bestellung und Zahlung bleiben im Panel.
• Vollständige API-Referenz veröffentlicht, inklusive Hostwolfs eigener Endpunkte für Mods, Spieler, Spieleinstellungen, Diagnose, Domains, Smart Backups und Minecraft-Netzwerke.