steam-mcp

Ein MCP-Server, der entscheidet, welche Steam-Spiele zu einer bestimmten Person passen. Er bewertet den Store anhand dessen, was der Spieler tatsächlich an Stunden spielt, kombiniert mit dem, was er gerade jetzt spielen möchte.

Zehn Tools. recommend_games ist die Eingangstür; die anderen existieren, damit eine Rangfolge hinterfragt werden kann, anstatt sie für bare Münze zu nehmen.

Ausführen

npm install && npm run build
claude mcp add -s user steam-mcp -e STEAM_ID=<your SteamID64> -- node /path/to/steam-mcp/dist/index.js

Umgebung:

• STEAM_ID (optional): Standardspieler, als SteamID64. Die Tools akzeptieren auch einen Vanity-Namen oder eine Profil-URL pro Aufruf.

• STEAM_API_KEY (optional): von https://steamcommunity.com/dev/apikey. Nur die Bibliotheks-, kürzlich gespielte- und Vanity-Auflösungspfade benötigen ihn. Alles andere, einschließlich der Wunschliste auf einem öffentlichen Profil, ist schlüssellos, sodass der Server ohne jegliche Anmeldedaten nützlich ist. Er kann nur nicht personalisieren.

Ein Disk-Cache befindet sich unter $XDG_CACHE_HOME/steam-mcp (Standard: ~/.cache). Der appdetails-Endpunkt des Stores ist auf etwa 200 pro fünf Minuten pro IP begrenzt; der Client taktet diesen Endpunkt mit 1,5 s, die anderen viel schneller, und cached aggressiv (Details sechs Stunden, Tags und Deck-Daten eine Woche), sodass eine zweite Empfehlung in derselben Sitzung größtenteils kostenlos ist. Jedes Tool, das eine Liste anreichert, arbeitet unter einer Frist und meldet, wie viele Spiele es übersprungen hat, sodass eine lange Anfrage eine teilweise Antwort zurückgibt, anstatt bei einem Proxy eine Zeitüberschreitung zu erleiden.

Related MCP server: Steam Review and Forum MCP

Wie die Rangfolge funktioniert

src/taste.ts enthält das gesamte Modell.

Profil. Die Stunden jedes gespielten Spiels werden seinen Community-Tags proportional zu ihrem Stimmenanteil zugeordnet, sodass die Stunden eines Milsims hauptsächlich auf Military und Tactical entfallen und nur ein kleiner Teil auf Multiplayer. Drei Korrekturen kommen hinzu:

• Tags werden nach Seltenheit gewichtet, abgeleitet aus der Beliebtheitsreihenfolge von Steams eigenem Tag-Wörterbuch (keine zusätzlichen Anfragen). Ohne dies beginnt jedes Profil mit Action, Open World, Simulation, egal wer der Spieler ist.

• Spiele von einem Studio werden vor der Komprimierung zusammengefasst. Drei Arma-Einträge sind drei Messungen eines Geschmacks, nicht dreimal so viele Beweise.

• Stunden werden quadratwurzeliert. Ein Ausreißer führt immer noch, schreibt aber nicht das gesamte Profil.

Zwei-Wochen-Spielzeit, wenn ein Schlüssel verfügbar ist, zählt zusätzlich zu den Lebenszeitstunden ein zweites Mal: einmal als Geschichte, einmal als das, wofür sich der Spieler gerade interessiert.

Punktzahl. Zwei Signale auf derselben 0..1-Skala, gleichmäßig gemischt: fit, der Kosinus zwischen dem Tag-Vektor des Kandidaten und dem Profil, relativ zum Besten, was ein Spiel erreichen könnte; und want, wie viel der Tag-Masse des Kandidaten dem entspricht, was der Spieler verlangt hat. Die Rezeption bestraft dann unterhalb von Steams „Mostly Positive“-Linie (70 %) und belohnt nie darüber, weil Kandidaten bereits nach Bewertungen sortiert ankommen und eine erneute Belohnung die Beliebtheit doppelt zählen würde. Jeder gemeldete matchedOn-Eintrag ist in Punkten angegeben und sagt, ob die Bibliothek oder die Anfrage ihn verdient hat.

Reihenfolge. Die endgültige Liste wird gierig nach Vielfalt neu sortiert: Ein Kandidat verliert bis zu 40 % seiner Punktzahl, wenn er etwas bereits Gewähltem ähnelt. Die Punktzahlen werden unverändert gemeldet; nur die Reihenfolge ändert sich, und die Tool-Beschreibung sagt dies.

Tests

npm test

Beide Testläufe laufen bewusst gegen die Live-API. test/smoke.mjs treibt den gebauten Server über echtes MCP stdio, was der einzige Ort ist, an dem ein stillschweigend entferntes Schema oder ein geänderter Store-Endpunkt sichtbar wird. test/taste.ts führt das Modell über test/fixtures/library.json aus, eine echte Bibliothek mit 45 Spielen, und prüft das Ranking-Verhalten anstatt exakter Zahlen, da Tag-Stimmen schwanken. Setzen Sie STEAM_API_KEY, um auch die schlüsselbasierten Tools zu testen.

Bereitstellung mit einem Schlüssel

Ein langlebiger stdio-Server kann seinen Schlüssel nicht von einem anfragebezogenen Secret-Broker erhalten, daher gehört die schlüsselbasierte Bereitstellung überall dorthin, wo eine Umgebungsvariable beim Prozessstart injiziert werden kann: eine supervisord-environment=-Zeile, eine Nomad-Variable, eine systemd-EnvironmentFile. Der Server liest STEAM_API_KEY einmal beim Start und schreibt ihn nie irgendwohin.