Kehittäjät/MCP-palvelin

Hostwolfin MCP-palvelin

@hostwolf/mcp antaa tekoälyavustajien hallita Hostwolf-pelipalvelimiasi. Se toimii Clauden, Cursorin, VS Coden ja minkä tahansa muun Model Context Protocolia tukevan asiakkaan kanssa. Kysy esimerkiksi:

• ”Miksi Minecraft-palvelimeni kaatui viime yönä?”
• ”Asenna EssentialsX ja käynnistä uudelleen.”
• ”Varmuuskopioi Valheim ja vaihda se sitten julkiseen testihaaraan.”
• ”Bannaa pelaaja griefer123 ja kerro kaikille miksi.”
• ”Käynnistä kaikki palvelimet uudelleen joka päivä klo 4.”

Käyttöönotto#

1. Luo API-avain osoitteessa panel.hostwolf.net/account/api.
2. Yhdistä asiakkaasi. Voit käyttää isännöityä palvelinta osoitteessa https://hostwolf.net/mcp (ei asennettavaa) tai ajaa sen itse ladattavasta paketista (vaatii Node.js 18+).

Isännöity: https://hostwolf.net/mcp#

Ei asennettavaa, ja aina uusin versio. Asiakkaasi lähettää avaimesi jokaisen pyynnön mukana; emme koskaan tallenna sitä.

claude mcp add --transport http hostwolf https://hostwolf.net/mcp --header "Authorization: Bearer ptlc_your_key"

{
  "mcpServers": {
    "hostwolf": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hostwolf.net/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer ptlc_your_key" }
    }
  }
}

{
  "mcpServers": {
    "hostwolf": {
      "url": "https://hostwolf.net/mcp",
      "headers": { "Authorization": "Bearer ptlc_your_key" }
    }
  }
}

{
  "servers": {
    "hostwolf": {
      "type": "http",
      "url": "https://hostwolf.net/mcp",
      "headers": { "Authorization": "Bearer ptlc_your_key" }
    }
  }
}

Asetukset lisätään URL-osoitteeseen: https://hostwolf.net/mcp?readonly=1 tarjoaa vain lukevat työkalut, ja ?servers=1a2b3c4d,5e6f7a8b rajaa avustajan näihin palvelimiin. Jos avaimesi on rajattu tiettyihin IP-osoitteisiin, salli myös 162.55.180.229, isännöidyn palvelimen osoite.

Aja itse#

Sama palvelin ladattavana. Se toimii omalla tietokoneellasi, joten avaimesi ei koskaan poistu sieltä.

claude mcp add hostwolf -e HOSTWOLF_API_KEY=ptlc_your_key -- npx -y https://hostwolf.net/dl/hostwolf-mcp-0.1.8.tgz

{
  "mcpServers": {
    "hostwolf": {
      "command": "npx",
      "args": ["-y", "https://hostwolf.net/dl/hostwolf-mcp-0.1.8.tgz"],
      "env": { "HOSTWOLF_API_KEY": "ptlc_your_key" }
    }
  }
}

{
  "mcpServers": {
    "hostwolf": {
      "command": "npx",
      "args": ["-y", "https://hostwolf.net/dl/hostwolf-mcp-0.1.8.tgz"],
      "env": { "HOSTWOLF_API_KEY": "ptlc_your_key" }
    }
  }
}

{
  "servers": {
    "hostwolf": {
      "command": "npx",
      "args": ["-y", "https://hostwolf.net/dl/hostwolf-mcp-0.1.8.tgz"],
      "env": { "HOSTWOLF_API_KEY": "ptlc_your_key" }
    }
  }
}

Asetukset#

Itse ajettavalle palvelimelle; isännöity palvelin ottaa sen sijaan ?readonly=1 ja ?servers= URL-osoitteessaan.

Työkalut#

Voit viitata palvelimiin tunnuksella tai nimellä (”survival-palvelimeni”). Jokainen työkalu kutsuu REST-rajapintaa SDK:n kautta, joten kaikki, mitä työkalu ei vielä osaa, on vain muutaman koodirivin päässä.

Tutki ja diagnosoi:

• list_servers: tila, osoite ja RAM-käyttö.
• get_server: yhden palvelimen tiedot.
• get_console: konsolin viimeisimmät rivit.
• diagnose_server: suorittaa ”Fix my server” -tarkistukset.
• list_players.

Ohjaus:

• power_server: käynnistä, pysäytä, käynnistä uudelleen tai pakota sammutus (kill).
• send_command.
• player_action: potkaise, bannaa, poista banni tai lähetä tiedote.
• reinstall_server.

Tiedostot:

• list_files.
• read_file: selaa pitkiä tiedostoja osissa.
• write_file.
• rename_file.
• delete_files.

Varmuuskopiot:

• list_backups.
• create_backup.
• restore_backup.
• delete_backup.

Asetukset:

• get_startup ja set_startup_variable.
• get_game_settings ja update_game_settings.
• get_game_versions ja set_game_version.

Modit:

• search_addons.
• list_installed_addons.
• install_addon ja uninstall_addon.
• search_modpacks ja install_modpack.

Tietokannat:

• list_databases: yhteystiedot ja kuka saa yhdistää ulkopuolelta.
• create_database: palvelimen ensimmäinen tietokanta odottaa noin 40 sekuntia, kun tietokantapalvelu käynnistyy.
• set_database_remote_access: salli muiden palvelinten IP-osoitteet tai kaikki, joilla on salasana.
• rotate_database_password ja delete_database.
• export_database ja import_database: tallenna .sql.gz koneellesi tai lataa sellainen. Vain itse ajettavassa palvelimessa.

Salasanat pysyvät piilossa, ellet pyydä avustajaasi näyttämään niitä.

Ajastukset:

• list_schedules.
• create_schedule.
• delete_schedule.

Tili:

• get_plans_and_prices: pelit, pakettikoot ja alueittaiset hinnat.
• list_orders.

Turvallisuus#

• Muutoksia tekevät työkalut on merkitty asiakasohjelmallesi. Tuhoavat työkalut on merkitty destructiveHint-merkinnällä, joten asiakasohjelmat kysyvät ennen niiden ajamista: pakotettu sammutus, palautus, tiedostojen, varmuuskopioiden, ajastusten tai tietokantojen poisto, tietokannan tuonti, uudelleenasennus, versionvaihto, modipaketin asennus ja tiedoston korvaaminen.
• HOSTWOLF_READONLY=1 (tai ?readonly=1 isännöidyn palvelimen URL-osoitteessa) poistaa kaikki työkalut, jotka muuttavat jotain.
• HOSTWOLF_SERVERS (tai ?servers=) rajaa avustajan tiettyihin palvelimiin.
• Isännöity palvelin tarkistaa avaimesi paneelilta, ei säilytä mitään pyyntöjen välillä eikä koskaan kirjaa avaimia tai työkalujen argumentteja. Sillä on pyyntörajat osoitetta ja avainta kohden.
• API-avaimilla ei voi tilata, perua tai maksaa palvelimia. Ne onnistuvat vain verkkopaneelissa.
• Voit luoda avustajallesi oman avaimen ja perua sen milloin tahansa paneelissa.

Vianmääritys#

• ”Send your Hostwolf API key” (401): asiakas ei lähettänyt otsaketta Authorization: Bearer ptlc_.... Tarkista otsake asetuksistasi.
• ”This API key was rejected by the panel” (401): avain on väärä, vajaa tai peruttu. Kopioi koko avain; se alkaa ptlc_.
• ”This API key has an IP allow-list…” (401): isännöity palvelin kutsuu APIa osoitteesta 162.55.180.229. Luo avain, joka sallii tämän osoitteen, tai avain ilman IP-rajausta, tai aja palvelin itse.
• ”Too many requests” (429): isännöity palvelin ottaa vastaan 300 pyyntöä minuutissa osoitetta kohden ja 180 avainta kohden. Työkalut ilmoittavat myös API:n omat rajat, kuten 2 varmuuskopiota 10 minuutissa, ja odotusajan sekunteina.
• ”Server busy” (503): yritä uudelleen muutaman sekunnin kuluttua.
• Pitkä työ näyttää pysähtyvän: jokainen työkalu vastaa 50 sekunnin kuluessa. Varmuuskopiot, palautukset, uudelleenasennukset ja modipakettien asennukset jatkuvat taustalla, joten pyydä avustajaasi tarkistamaan tilanne työkaluilla get_server tai list_backups.
• Uusi tietokanta sanoo ”valmistellaan”: create_database odottaa enintään 2 minuuttia (isännöidyllä palvelimella 75 sekuntia), että tietokantapalvelu käynnistyy. Jos se ei ole valmis siihen mennessä, työkalu kertoo sen, ja tietokanta näkyy pian sen jälkeen työkalussa list_databases.

Päivittäminen#

Isännöity palvelin on aina ajan tasalla. Itse ajettavan kohdalla npx tallentaa palvelimen välimuistiin sen URL-osoitteen mukaan, joten se ei koskaan päivity itsestään. Jokaisella versiolla on oma URL, ja palvelin tarkistaa käynnistyessään tiedoston hostwolf.net/dl/index.json. Jos uudempi versio on olemassa, se kirjaa ilmoituksen ja lisää sen list_servers-tulokseen, jotta avustajasi kertoo siitä. Päivitä vaihtamalla versio asetustesi URL-osoitteessa ja käynnistämällä asiakas uudelleen.

Rakennettu SDK:n päälle#

Työkalut käyttävät kirjastoa @hostwolf/sdk, joka on mukana tässä paketissa. Jos haluat upottaa palvelimen omaan sovellukseesi, asenna molemmat paketit:

npm install https://hostwolf.net/dl/hostwolf-sdk-0.1.8.tgz https://hostwolf.net/dl/hostwolf-mcp-0.1.8.tgz

import { Hostwolf } from '@hostwolf/sdk';
import { createHostwolfMcp } from '@hostwolf/mcp/server';

Lisenssi#

MIT