Développeurs/Journal des modifications

Journal des modifications

Versions du SDK TypeScript, du serveur MCP et de l’API REST. Chaque version du SDK et du MCP a une URL de téléchargement fixe ; les versions actuelles et les sommes de contrôle sont dans index.json.

SDK et MCP 0.1.8#

11 octobre 2026

• SDK : databases.create() gère la première base d’un serveur, qui répond 202 pendant que le service de bases de données démarre (environ 40 secondes). Il renvoie un résultat en attente (vérifiez-le avec isDatabasePending()), ou passez { wait: true } pour obtenir la base terminée. databases.waitUntilReady() se charge aussi de l’attente à lui seul. Bases de données
• SDK : nouveaux databases.service(), setRemoteAccess(), export() et import(). Les bases indiquent désormais remote_ips, remote_anywhere et remote_address.
• MCP : nouveaux outils de bases de données : list_databases, create_database (attend par défaut un nouveau service de bases de données), set_database_remote_access, rotate_database_password et delete_database. Le serveur auto-hébergé propose aussi export_database et import_database. Les mots de passe restent masqués, sauf si vous les demandez.

API REST#

11 octobre 2026

• Nouveau : les bases de données tournent sur la machine de votre serveur. Le premier POST /databases répond 202 Accepted avec l’état du service de bases de données ; la base apparaît environ 40 secondes plus tard. Détails
• Nouveau : GET /databases/service, POST /databases/{id}/remote (IP distantes ou remote_anywhere), GET /databases/{id}/export et POST /databases/{id}/import.
• Changement : chaque serveur inclut 5 bases de données. Le champ remote à la création est ignoré ; utilisez plutôt remote_ips.

SDK et MCP 0.1.7#

10 octobre 2026

• SDK : de nouveaux assistants qui attendent pour vous : servers.waitForState(), backups.waitUntilDone() et waitForConsole(), qui envoie une commande et renvoie la ligne de réponse correspondante.
• SDK : files.upload() et files.download() gèrent les fichiers binaires comme les jars de plugins et les archives de monde, et files.exists() vérifie un chemin.
• SDK : lire un fichier manquant lève désormais 404 avec le code NotFound au lieu du 500 générique du nœud.
• SDK : users.create() prend l’identifiant public de l’autre compte (HW-XXXXXX), comme l’exige l’API. Passer un e-mail échoue tout de suite avec un message clair.
• SDK : account.apiKeys.create() renvoie désormais la clé complète et utilisable dans token. Avant, seule la partie secrète était renvoyée.
• SDK : des erreurs plus claires pour une clé erronée ou révoquée, et les dépassements de délai indiquent désormais l’appel concerné. account.updateLanguage() accepte une devise en option.
• MCP hébergé : une clé dont la liste d’adresses autorisées n’inclut pas le serveur hébergé (162.55.180.229) reçoit désormais une erreur qui le dit.
• Docs : elles se trouvent désormais sur game.hostwolf.net/developers, avec de nouvelles sections sur la liste d’adresses IP autorisées, toutes les limites de requêtes et le dépannage MCP.

API REST#

10 octobre 2026

• Correctif : chaque action limitée a désormais son propre compteur. Avant, elles en partageaient un, si bien que quelques recherches d’addons pouvaient bloquer le changement de version ou l’installation de modpack suivant avec 429.
• Correctif : POST /game/version avec une version qui n’existe pas renvoie 422 unknown_version. Avant, c’était signalé comme un retour en arrière, et avec force le serveur était réinstallé sur cette version.
• Correctif : installer un modpack ou une version qui n’existe pas renvoie 404 avec un message clair au lieu de « Modrinth is not responding ».
• Correctif : l’envoi d’avatars (POST /account/avatar) fonctionne de nouveau.

MCP 0.1.6#

7 octobre 2026

• MCP hébergé : une clé API révoquée cesse désormais de fonctionner en 2 minutes au plus (contre 10).
• MCP hébergé : quand trop de requêtes arrivent en même temps, le serveur répond 503 avec Retry-After au lieu de ralentir pour tout le monde.

MCP 0.1.5#

7 octobre 2026

• Correctif : le serveur exécuté par vous-même ne démarrait pas via npx en 0.1.3 et 0.1.4. Si vous utilisez l’une de ces versions, passez à 0.1.5 dans votre configuration. Le serveur hébergé n’était pas concerné.
• MCP : le mode hébergé s’appelle désormais hostwolf-mcp --http.

MCP 0.1.4#

7 octobre 2026

• MCP : le serveur hébergé n’écrit plus une ligne de journal à chaque contrôle de santé.

MCP hébergé et 0.1.3#

7 octobre 2026

• Nouveau : le serveur MCP est hébergé sur https://hostwolf.net/mcp. Connectez Claude Code, Cursor ou VS Code avec simplement l’URL et votre clé API ; rien à installer, et toujours à jour. Configuration
• MCP : hostwolf-mcp --http fait tourner le même serveur en Streamable HTTP, pour ceux qui veulent l’héberger eux-mêmes.
• Exemples de la documentation et README mis à jour. Le code du SDK est inchangé depuis la 0.1.2.

SDK et MCP 0.1.2#

6 octobre 2026

• SDK : les limites avec un long Retry-After (comme 2 sauvegardes par 10 minutes) échouent désormais tout de suite au lieu d’attendre. L’attente est dans error.retryAfter, et la nouvelle option maxRetryWaitMs règle combien de temps le SDK attend de lui-même.
• MCP : les erreurs de limite de requêtes indiquent à l’assistant quand réessayer.

SDK et MCP 0.1.1#

6 octobre 2026

• SDK : les requêtes qui dépassent le délai ne sont plus relancées, pour qu’un endpoint lent n’accumule pas plusieurs délais. servers.resources() accepte une option timeoutMs.
• MCP : les statistiques en direct de list_servers et get_server abandonnent au bout de 5 secondes au lieu de bloquer, et chaque outil répond en moins de 50 secondes, avant l’expiration côté clients IA.
• MCP : nouveaux outils delete_backup et delete_schedule.
• MCP : vérifie les nouvelles versions au démarrage et les signale dans list_servers.

SDK et MCP 0.1.0#

6 octobre 2026

• Première version du SDK TypeScript : tous les endpoints de l’API client, réponses typées, console en direct, pagination, relances et erreurs.
• Première version du serveur MCP pour Claude, Cursor et VS Code.

API REST#

6 octobre 2026

• Nouveau : endpoints en lecture seule pour les offres et commandes avec les clés API : GET /store/catalog, /store/orders et /store/billing. La commande et le paiement restent dans le panel.
• Publication de la référence complète de l’API, y compris les endpoints propres à Hostwolf pour les mods, les joueurs, les paramètres de jeu, le diagnostic, les domaines, les sauvegardes intelligentes et les réseaux Minecraft.