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 +70 -0
- package/README.md +83 -24
- package/dist/index.js +367 -186
- package/dist/index.js.map +1 -1
- package/package.json +2 -1
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
|
|
48
|
-
| `get_items` | – | Batch store card (price, review %, release) for a LIST of appids — one call
|
|
49
|
-
| `
|
|
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
|
|
68
|
-
and batch price/review checks (`get_items`).
|
|
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).
|