Kehittäjät/MCP-palvelin

Hostwolf Apps -MCP-palvelin

@hostwolf/apps-mcp antaa tekoälyavustajien julkaista ja ajaa sovelluksiasi Hostwolf Appsissa. Se toimii Clauden, Cursorin, VS Coden ja minkä tahansa muun Model Context Protocolia tukevan asiakkaan kanssa. Voit pyytää esimerkiksi:

• ”Miksi kauppani viimeisin julkaisu epäonnistui?”
• ”Julkaise github.com/acme/api sovelluspalvelimelleni, kuuntelemaan porttia 8080.”
• ”Aseta STRIPE_KEY api-sovellukselle ja julkaise se uudelleen.”
• ”Luo pieni Postgres-tietokanta Amsterdamiin ja yhdistä se kauppaan.”
• ”Anna kaupan skaalautua 4 kopioon, mutta pidä automaattinen skaalaus alle 40 dollarissa kuukaudessa.”
• ”Lisää sovelluspalvelimelleni 50 Gt:n levy varmuuskopioineen ja kerro ensin hinta.”

Asennus#

1. Luo API-tunnus konsolissa kohdassa Avaimet ja tunnukset → API-tunnukset. Valitse täyteen käyttöön Luku, Kirjoitus ja Julkaisu; lisää Arkaluonteisten tietojen luku, jos avustajan pitää lukea lokeja ja muuttujien arvoja.
2. Yhdistä asiakkaasi. Voit käyttää isännöityä palvelinta osoitteessa https://app.hostwolf.net/mcp (ei asennettavaa) tai ajaa sen itse ladattavasta paketista (vaatii Node.js 18+:n).

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

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

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

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

{
  "mcpServers": {
    "hostwolf-apps": {
      "url": "https://app.hostwolf.net/mcp",
      "headers": { "Authorization": "Bearer your_token" }
    }
  }
}

{
  "servers": {
    "hostwolf-apps": {
      "type": "http",
      "url": "https://app.hostwolf.net/mcp",
      "headers": { "Authorization": "Bearer your_token" }
    }
  }
}

Lisää URL-osoitteeseen ?readonly=1 (https://app.hostwolf.net/mcp?readonly=1), niin tarjolla on vain lukevia työkaluja.

Aja itse#

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

claude mcp add hostwolf-apps -e HOSTWOLF_APPS_TOKEN=your_token -- npx -y https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz

{
  "mcpServers": {
    "hostwolf-apps": {
      "command": "npx",
      "args": ["-y", "https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz"],
      "env": { "HOSTWOLF_APPS_TOKEN": "your_token" }
    }
  }
}

{
  "mcpServers": {
    "hostwolf-apps": {
      "command": "npx",
      "args": ["-y", "https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz"],
      "env": { "HOSTWOLF_APPS_TOKEN": "your_token" }
    }
  }
}

{
  "servers": {
    "hostwolf-apps": {
      "command": "npx",
      "args": ["-y", "https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz"],
      "env": { "HOSTWOLF_APPS_TOKEN": "your_token" }
    }
  }
}

Asetukset#

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

HTTP-palvelimen ajaminen itse#

hostwolf-apps-mcp --http ajaa saman Streamable HTTP -päätepisteen, jota isännöimme osoitteessa app.hostwolf.net/mcp, tiimeille, jotka haluavat oman. Se on tilaton: jokainen pyyntö kantaa kutsujan omaa tunnusta muodossa Authorization: Bearer …, eikä mitään tallenneta.

npm install -g https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz
HOST=0.0.0.0 PORT=8791 hostwolf-apps-mcp --http
curl http://localhost:8791/mcp/health

cat > Dockerfile <<'EOF'
FROM node:22-alpine
RUN npm install -g --omit=dev https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz && npm cache clean --force
ENV HOST=0.0.0.0 PORT=8791
USER node
EXPOSE 8791
CMD ["hostwolf-apps-mcp", "--http"]
EOF
docker build -t hostwolf-apps-mcp .
docker run -d --name hostwolf-apps-mcp --memory 192m -p 127.0.0.1:8791:8791 hostwolf-apps-mcp

Laita se HTTPS-välityspalvelimesi taakse ja osoita sitten asiakkaat osoitteeseen https://your-host/mcp kuten yllä olevassa isännöidyssä asetuksessa.

Rajat: 300 pyyntöä minuutissa asiakasosoitetta kohden ja 180 tunnusta kohden, 2 Mt pyyntöjen rungot, 32 pyyntöä kerrallaan. Pääsyloki näyttää ajan, osoitteen, tunnuksen SHA-256-tiivisteen 8 ensimmäistä merkkiä, työkalun nimen ja tilan, ei koskaan tunnusta tai työkalun argumentteja.

Työkalut#

Sovellukset:

• list_apps: kaikki sovellukset tiloineen, verkkotunnuksineen, lähteineen, projekteineen ja ympäristöineen.
• get_app: asetukset, palvelimet, viimeisimmät julkaisut ja muuttujien nimet.
• get_app_logs: kontin viimeisin tuloste (tunnus tarvitsee arkaluonteisten tietojen lukuoikeuden).
• get_app_metrics: suoritin ja muisti.
• create_app_from_git, create_app_from_dockerfile, create_app_from_image.
• update_app: nimi, verkkotunnukset, portit, haara, komennot, terveystarkistus.
• deploy_app: tekee buildin ja odottaa tulosta noin 40 sekuntia.
• restart_app, stop_app, delete_app.

Ympäristömuuttujat:

• list_env_vars: arvot on peitetty, ellet pyydä avustajaa näyttämään niitä.
• set_env_vars: luo tai päivitä useita kerralla, halutessasi salaisuuksina, joita ei voi lukea takaisin.
• delete_env_var.

Julkaisut:

• list_deployments: sovelluksen viimeisimmät julkaisut tai se, mikä on nyt käynnissä.
• get_deployment: tila ja koontilokin loppu.
• cancel_deployment.

Projektit:

• list_projects, create_project, create_environment, delete_project.

Palvelimet:

• list_servers: sovelluspalvelimesi ja VPS-palvelimesi koon, kaupungin, tilan ja hinnan kanssa.
• get_server: mitä palvelimella ajetaan, sen verkkotunnukset ja kuorma.
• add_app_server, remove_app_server: aja sovelluksen kopioita usealla palvelimellasi.
• get_traffic: tämän kuun lähtevä liikenne ja sen lasku tähän mennessä, palvelimittain tai koko tiimille.
• list_regions: kaupungit kokokohtaisine hintoineen ja tieto siitä, mihin automaattinen skaalaus voi lisätä palvelimia.

Tallennustaltiot (palvelimiesi levyt):

• list_storage_volumes, get_storage_volume_price.
• add_storage_volume, update_storage_volume (suurentaminen, varmuuskopiot, automaattinen kasvu): avustaja näyttää hinnan ja tarvitsee vahvistuksesi.
• detach_storage_volume, attach_storage_volume: siirrä taltio palvelimiesi välillä samassa kaupungissa.
• list_storage_volume_backups, backup_storage_volume, restore_storage_volume, delete_storage_volume.

Sovellusten taltiot:

• list_volumes, add_volume, delete_volume.
• backup_volume: varmuuskopioaikataulu, varmuuskopio heti tai molemmat.

Hallinnoidut tietokannat:

• list_databases, get_database_plans.
• get_database: tila sekä poolattu ja suora yhteys-URL; salasana on peitetty, ellet pyydä sitä.
• create_database: laskutetaan tunneittain, joten se vaatii vahvistuksesi.
• attach_database: tallentaa poolatun URL-osoitteen muuttujaan DATABASE_URL ja suoran muuttujaan DATABASE_DIRECT_URL (tai REDIS_URL) näyttämättä niitä. Jos sovellus käyttää näitä nimiä jo muuhun, mitään ei tallenneta ja tarjolla on vapaa nimi (env_key) tai overwrite.
• upgrade_database: suurempi paketti; avustaja näyttää uuden hinnan ja tarvitsee vahvistuksesi.
• set_database_eviction_policy: mitä Redis tekee, kun sen muisti on täynnä.
• backup_database, delete_database.

Automaattinen skaalaus ja tiimi:

• get_autoscaling: käytäntö, käynnissä olevat kopiot, suoritinkuorma ja tämän kuun kulut.
• set_autoscaling: käyttöön ottaminen tai rajojen nostaminen vaatii vahvistuksesi.
• get_team.

Turvallisuus#

• Tuhoavat työkalut (pysäytys, poisto, palvelinkopion poistaminen, muuttujien, taltioiden tai tietokantojen poistaminen) on merkitty destructiveHint-vihjeellä, eivätkä ne suostu toimimaan ennen kuin avustaja antaa confirm: true, minkä se saa tehdä vain, kun olet hyväksynyt. Samoin toimivat maksulliset työkalut: tietokannan luominen tai päivittäminen, tallennustaltion lisääminen tai suurentaminen ja automaattisen skaalauksen rajojen nostaminen. Ilman confirm-parametria kutsuttuina ne vastaavat hinnalla, jotta avustaja voi näyttää sen sinulle ensin.
• Tietokantojen salasanat ja muuttujien arvot on peitetty, ellet pyydä niitä. attach_database antaa URL-osoitteen sovellukselle ilman, että avustaja koskaan näkee sitä.
• HOSTWOLF_READONLY=1 (tai ?readonly=1 isännöidyn palvelimen URL-osoitteessa) poistaa kaikki kirjoittavat työkalut. API-tunnus, jolla on vain Luku-oikeus, tekee saman rajapinnan puolella.
• Isännöity palvelin tarkistaa tunnuksesi konsolilta, ei säilytä mitään pyyntöjen välillä eikä koskaan kirjaa lokiin tunnuksia tai työkalujen argumentteja. Sillä on pyyntörajoitus osoitetta ja tunnusta kohden.
• API-tunnuksilla ei voi ostaa tai perua palvelimia. Ne toiminnot onnistuvat vain konsolissa.
• Luo avustajallesi oma erillinen tunnus ja peru se milloin tahansa kohdassa Avaimet ja tunnukset.

Päivittäminen#

Isännöity palvelin on aina ajan tasalla. Itse ajettavan palvelimen npx välimuistittaa URL-osoitteen mukaan, joten se ei koskaan päivity itsestään. Jokaisella versiolla on oma URL, ja palvelin tarkistaa käynnistyessään app.hostwolf.net/dl/index.json:n. Jos uudempi versio on olemassa, se kirjaa lokiin ilmoituksen ja lisää sen list_apps-tulokseen, jotta avustajasi kertoo sinulle. 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 @hostwolf/apps-sdk:ta, joka on paketoitu tämän paketin sisään. Jos haluat upottaa palvelimen omaan sovellukseesi, asenna molemmat paketit:

npm install https://app.hostwolf.net/dl/hostwolf-apps-sdk-0.2.1.tgz https://app.hostwolf.net/dl/hostwolf-apps-mcp-0.2.1.tgz

import { HostwolfApps } from '@hostwolf/apps-sdk';
import { createHostwolfAppsMcp } from '@hostwolf/apps-mcp/server';

Lisenssi#

MIT