steam-games-mcp 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,76 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.4.0] - 2026-06-30
10
+
11
+ ### Added
12
+
13
+ - **MCP logging capability.** The server now declares the `logging` capability and
14
+ mirrors its stderr log lines to the connected client as `notifications/message`,
15
+ so MCP hosts can surface server logs in their UI and adjust verbosity at runtime
16
+ via `logging/setLevel`. stderr logging is unchanged; the new channel is
17
+ best-effort, credential-redacted, and gated by the same `LOG_LEVEL` threshold.
18
+
19
+ ### Changed
20
+
21
+ - **Internal: `src/format.ts` split into `src/format/`** (`storefront.ts`, `web.ts`,
22
+ shared helpers in `shared.ts`), mirroring the `clients/` and `tools/` layout. No
23
+ behavior change; public tool output is identical.
24
+ - `npm run test:coverage` now enforces the 80%-lines gate locally (previously only
25
+ in CI), so coverage regressions are caught before pushing. Falls back to
26
+ report-only on Node < 22.8 (the threshold flag's minimum).
27
+
28
+ ### Fixed
29
+
30
+ - Logger stderr prefix said `[mal-mcp]` (template leftover); now `[steam-games-mcp]`.
31
+ - `redact()` now masks the Steam Web API `key` query param. It travels in request
32
+ URLs that are logged at debug level, so it could previously leak into logs (and,
33
+ with the new MCP logging channel, to clients).
34
+
35
+ ### Removed
36
+
37
+ - Dead `src/lib/tokenStore.ts` — a MAL OAuth-token persistence leftover from the
38
+ template, unused here (Steam auth is a single env key, no token rotation).
39
+
40
+ ## [0.3.0]
41
+
42
+ ### Changed
43
+
44
+ - **`discover_deals` merged into `discover_games`** (breaking). They were the same
45
+ catalog query with different presets, so they collapse into one tool. Pass
46
+ `min_discount` for deals, `released_after` / `released_within_days` for new
47
+ releases, `steam_deck` for Deck-capable games, and `min_review` / `min_reviews`
48
+ for rating — in any combination. Migration: replace
49
+ `discover_deals({ min_discount })` with `discover_games({ min_discount })`.
50
+
51
+ ### Added
52
+
53
+ - `STEAM_ID` config (env / `.mcpb` user_config): set a default player — a 17-digit
54
+ SteamID64 or a vanity name (resolved once via the Web API) — so the player tools
55
+ (`get_wishlist`, `get_owned_games`, `get_recently_played`, `get_player_summary`,
56
+ `get_player_achievements`) default to you. Their `steamid` argument is now
57
+ optional and falls back to `STEAM_ID`; ask "my wishlist" without passing an ID.
58
+ - `get_game` now accepts a `name` as an alternative to `appid` — a title is
59
+ resolved to the closest store match, so you can look a game up without an appid.
60
+ - `get_player_achievements` gains a per-call `language` override for achievement
61
+ names/descriptions, matching `get_game_achievements` (falls back to `STEAM_LANGUAGE`).
62
+ - `discover_games` — find games catalog-wide (keyless) by discount, release recency
63
+ (`released_after` / `released_within_days`), **Steam Deck** compatibility and
64
+ review quality, in any combination. Sorts the catalog by popularity so the scanned
65
+ window holds real games with genuine Deck ratings and review counts (the default
66
+ appid order surfaced Deck-untested shovelware). Answers both "games >80% off with
67
+ 90%+ reviews" and "recent well-reviewed games that run on Steam Deck".
68
+ - **Steam Deck compatibility** (`verified` / `playable` / `unsupported` / `unknown`)
69
+ is reported by `get_items` and `discover_games` (via `include_platforms`), with a
70
+ `steam_deck` filter on `discover_games`. Note: Steam's catalog API has no
71
+ server-side Deck filter or release-date sort, so the Deck/recency/review filters
72
+ are applied over the popularity-sorted page (raise `count` for stricter filters).
73
+
74
+ ### Docs
75
+
76
+ - README: natural-language example queries and a step-by-step
77
+ "Getting your credentials" guide (API key, Steam ID, public profile).
78
+
9
79
  ## [0.2.0]
10
80
 
11
81
  ### Changed
package/README.md CHANGED
@@ -10,6 +10,37 @@ profiles, libraries and achievements via the official **Steam Web API** (free ke
10
10
 
11
11
  Works with any MCP client (Claude Desktop/Code, Cursor, VS Code, Cline, …) over stdio.
12
12
 
13
+ Once it's connected, just ask your agent in natural language.
14
+
15
+ **No credentials needed** (store, search & discovery):
16
+
17
+ ```
18
+ "Find Hollow Knight and tell me its price, genres and age rating."
19
+ "What are recent reviews saying about Baldur's Gate 3?"
20
+ "Have Cyberpunk 2077's reviews recovered since launch?"
21
+ "Which games are >80% off right now with 90%+ positive reviews?"
22
+ "Which recent, well-reviewed games run on Steam Deck?"
23
+ "What's discounted on Steam's front page right now?"
24
+ "Show me Steam's top sellers and newest releases."
25
+ "Any recent patch notes for No Man's Sky?"
26
+ "How rare is each achievement in Elden Ring?"
27
+ "How many people are playing Counter-Strike 2 right now?"
28
+ "Get current prices for appids 620, 413150 and 1145360."
29
+ "For appids 1245620 and 1086940, show price, review % and Steam Deck status."
30
+ ```
31
+
32
+ **With a free API key + your `STEAM_ID`** (your account; see [Getting your credentials](#getting-your-credentials)):
33
+
34
+ ```
35
+ "Show my Steam profile."
36
+ "List my games by playtime."
37
+ "What have I played in the last two weeks?"
38
+ "What's on my wishlist that's discounted and well-reviewed?"
39
+ "List Hollow Knight's achievements and how rare each one is."
40
+ "How far am I through Elden Ring's achievements?"
41
+ "What's the SteamID64 for the profile name 'gabelogannewell'?"
42
+ ```
43
+
13
44
  ## Install
14
45
 
15
46
  Add it to your MCP client's config. Store/search tools work with **no
@@ -23,6 +54,7 @@ credentials**; player tools need a free Steam Web API key.
23
54
  "args": ["-y", "steam-games-mcp"],
24
55
  "env": {
25
56
  "STEAM_API_KEY": "your-steam-web-api-key (optional — enables player tools)",
57
+ "STEAM_ID": "your-steamid64-or-vanity-name (optional — default 'you' for player tools)",
26
58
  "STEAM_COUNTRY": "US (optional — store price region)",
27
59
  "STEAM_LANGUAGE": "english (optional — store language)"
28
60
  }
@@ -37,37 +69,64 @@ credentials**; player tools need a free Steam Web API key.
37
69
  > `"args": ["/ABS/PATH/steam-games-mcp/dist/index.js"]`. **As a `.mcpb` bundle:** grab it
38
70
  > from the [latest release](https://github.com/Grinv/steam-games-mcp/releases/latest).
39
71
 
72
+ ## Getting your credentials
73
+
74
+ Store, search and discovery tools need **nothing** — skip this section if that's
75
+ all you want. The **player** tools (profile, library, achievements, your wishlist)
76
+ need a free API key and a public profile. Three short steps:
77
+
78
+ 1. **Get a free Steam Web API key.** Sign in at
79
+ <https://steamcommunity.com/dev/apikey>, enter any domain (e.g. `localhost`),
80
+ and copy the key into `STEAM_API_KEY`.
81
+ 2. **Find your Steam ID.** Set `STEAM_ID` to either:
82
+ - your **vanity name** — the custom part of your profile URL
83
+ `steamcommunity.com/id/YOUR_NAME` → `YOUR_NAME` (resolved automatically), or
84
+ - your **17-digit SteamID64** (`steamcommunity.com/profiles/7656…`; or look it
85
+ up at <https://steamid.io>).
86
+
87
+ With `STEAM_ID` set you can just ask "_my_ wishlist / library" — without it,
88
+ give the agent a SteamID64 each time (use `resolve_vanity_url` to convert a name).
89
+
90
+ 3. **Make your profile public** (for your own library/achievements): Steam →
91
+ profile → **Edit Profile** → **Privacy Settings** → set **My profile** and
92
+ **Game details** to **Public**.
93
+
94
+ > The key and Steam ID go in your MCP client config (the `env` block above) — see
95
+ > [docs/clients.md](docs/clients.md) for per-client examples. Never commit them.
96
+
40
97
  ## What it does
41
98
 
42
99
  Key: **–** no credentials · **K** Steam Web API key.
43
100
 
44
- | Tool | Key | Purpose |
45
- | ------------------------- | --- | ---------------------------------------------------------------------------------- |
46
- | `search_games` | – | Find games by title → appid (with price) |
47
- | `get_game` | – | Store details: price, genres, platforms, Metacritic, age rating, DLC, requirements |
48
- | `get_items` | – | Batch store card (price, review %, release) for a LIST of appids — one call |
49
- | `discover_deals` | – | Find catalog-wide discounts by min % (with review %) — no appids needed |
50
- | `get_game_reviews` | – | Review summary + recent reviews |
51
- | `get_review_histogram` | – | Review trend over time (history + recent) |
52
- | `get_prices` | – | Batch current price/discount for many appids |
53
- | `get_specials` | – | Steam front-page discounts |
54
- | `get_featured` | – | Featured sections (top sellers, new releases, …) |
55
- | `get_game_news` | – | Recent news / patch notes |
56
- | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
57
- | `get_current_players` | – | Live concurrent player count |
58
- | `get_wishlist` | – | A player's wishlist appids (public profiles) |
59
- | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
60
- | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
61
- | `get_player_summary` | K | Player public profile |
62
- | `get_owned_games` | K | A player's games + playtime |
63
- | `get_recently_played` | K | Games played in the last two weeks |
64
- | `get_player_achievements` | K | A player's achievement progress in a game |
101
+ | Tool | Key | Purpose |
102
+ | ------------------------- | --- | ------------------------------------------------------------------------------------------------------- |
103
+ | `search_games` | – | Find games by title → appid (with price) |
104
+ | `get_game` | – | Store details by appid **or name**: price, genres, platforms, Metacritic, age rating, DLC, requirements |
105
+ | `get_items` | – | Batch store card (price, review %, **Steam Deck**, release) for a LIST of appids — one call |
106
+ | `discover_games` | – | Find games catalog-wide by **discount**, **recency**, **Steam Deck** and rating — no appids needed |
107
+ | `get_game_reviews` | – | Review summary + recent reviews |
108
+ | `get_review_histogram` | – | Review trend over time (history + recent) |
109
+ | `get_prices` | – | Batch current price/discount for many appids |
110
+ | `get_specials` | – | Steam front-page discounts |
111
+ | `get_featured` | – | Featured sections (top sellers, new releases, …) |
112
+ | `get_game_news` | – | Recent news / patch notes |
113
+ | `get_global_achievements` | – | Global achievement unlock rates (rarity) |
114
+ | `get_current_players` | – | Live concurrent player count |
115
+ | `get_wishlist` | – | A player's wishlist appids (public profiles) |
116
+ | `get_game_achievements` | K | Full achievement list (names, descriptions) + rarity |
117
+ | `resolve_vanity_url` | K | Custom profile name → SteamID64 |
118
+ | `get_player_summary` | K | Player public profile |
119
+ | `get_owned_games` | K | A player's games + playtime |
120
+ | `get_recently_played` | K | Games played in the last two weeks |
121
+ | `get_player_achievements` | K | A player's achievement progress in a game |
65
122
 
66
123
  **Two tiers.** Store/search + discovery tools (`store`/`api.steampowered.com`)
67
- need **no credentials** — including catalog-wide deal discovery (`discover_deals`)
68
- and batch price/review checks (`get_items`). Player tools need a free
124
+ need **no credentials** — including catalog-wide discovery (`discover_games`:
125
+ deals, new releases, Steam Deck, rating) and batch price/review checks (`get_items`).
126
+ Player tools need a free
69
127
  **`STEAM_API_KEY`** and a **public** profile; they return a clear message when the
70
- key is unset.
128
+ key is unset. Set **`STEAM_ID`** (a SteamID64 or vanity name) to make those tools
129
+ default to you, so "my wishlist / library" works without passing an ID each time.
71
130
 
72
131
  > No third-party services: deal discovery and reviews come from Steam's own
73
132
  > (keyless) store APIs. SteamDB is not used (no public API + scraping disallowed).