steam-games-mcp

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Uyari
  • process.env — Environment variable access in scripts/check-api.mjs
  • network request — Outbound network request in scripts/check-api.mjs
  • process.env — Environment variable access in scripts/preversion-check.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

MCP server for Steam: keyless store/catalog data (deals, tags, SteamOS/Deck/Frame compat) plus player profiles, libraries and achievements via the Steam Web API.

README.md

Steam MCP Server

npm version
CI
license: MIT
MCP Registry
steam-games-mcp MCP server

An MCP server for Steam: search games and
read store details, prices, reviews, discounts and news (no key), plus player
profiles, libraries and achievements via the official Steam Web API (free key).

Read-only · official Steam APIs only · most tools need no key · open source.

Nobody logs in; the only credential is a free Steam Web API key you set yourself,
and the server never writes, trades, posts, launches games, or makes purchases.

Works with any MCP client (Claude Desktop/Code, Cursor, VS Code, Cline, …) over stdio.

Once it's connected, just ask your agent in natural language.

No credentials needed (store, search & discovery):

"Find Hollow Knight and tell me its price, genres and age rating."
"What are recent reviews saying about Baldur's Gate 3?"
"Have Cyberpunk 2077's reviews recovered since launch?"
"Which games are >80% off right now with 90%+ positive reviews?"
"Find roguelike deckbuilders on sale."
"What discounted games run natively on macOS?"
"Which recent, well-reviewed games run on Steam Deck?"
"What well-reviewed games run on SteamOS?"
"Any games verified for the Steam Machine on sale?"
"Any Steam Frame-Verified VR games on sale?"
"What's discounted on Steam's front page right now?"
"Show me Steam's top sellers and newest releases."
"Any recent patch notes for No Man's Sky?"
"How rare is each achievement in Elden Ring?"
"How many people are playing Counter-Strike 2 right now?"
"What are the most played games on Steam right now?"
"Get current prices for appids 620, 413150 and 1145360."
"For appids 1245620 and 1086940, show price, review % and Deck / SteamOS / Machine / Frame status."

With a free API key + your STEAM_ID (your account; see Getting your credentials):

"Show my Steam profile."
"List my games by playtime."
"What have I played in the last two weeks?"
"Recommend something I'd like based on my library, on a good discount."
"Do I already own Hollow Knight and Hades?"
"What's on my wishlist that's discounted and well-reviewed?"
"List Hollow Knight's achievements and how rare each one is."
"How far am I through Elden Ring's achievements?"
"What's the SteamID64 for the profile name 'gabelogannewell'?"
"Which of my friends own Portal 2, and how many hours have they played?"
"What games do my friend and I both own, and who's played them more?"
"Show me my Steam friends list."
"Is SteamID 76561197960287930 VAC banned?"
"What games am I following that aren't on my wishlist?"

Install

Add it to your MCP client's config. Store/search tools work with no
credentials
; player tools need a free Steam Web API key.

{
  "mcpServers": {
    "steam": {
      "command": "npx",
      "args": ["-y", "steam-games-mcp"],
      "env": {
        "STEAM_API_KEY": "your-steam-web-api-key (optional — enables player tools)",
        "STEAM_ID": "your-steamid64-or-vanity-name (optional — default 'you' for player tools)",
        "STEAM_COUNTRY": "US (optional — store price region)",
        "STEAM_LANGUAGE": "english (optional — store language)"
      }
    }
  }
}

Replace each value with your own; remove the optional lines you don't need.
A free key comes from https://steamcommunity.com/dev/apikey. From source:
npm ci && npm run build, then use "command": "node",
"args": ["/ABS/PATH/steam-games-mcp/dist/index.js"].

One-click install (Claude Desktop)

Download steam-games-mcp.mcpb
(always the latest release) and open it in Claude Desktop (Settings → Extensions), then
fill the optional fields (API key, Steam ID, country, language) in the install form. No JSON editing.

Also listed in the MCP Registry
as io.github.Grinv/steam-games-mcp.

Getting your credentials

Store, search and discovery tools need nothing; skip this section if that's
all you want. The player tools (profile, library, achievements)
need a free API key, and most also need a public profile — though get_wishlist
and get_followed_games need no key, and profile/ban lookups work on private
profiles. Three short steps:

  1. Get a free Steam Web API key. Sign in at
    https://steamcommunity.com/dev/apikey, enter any domain (e.g. localhost),
    and copy the key into STEAM_API_KEY.

  2. Find your Steam ID. Set STEAM_ID to either:

    • your vanity name: the custom part of your profile URL
      steamcommunity.com/id/YOUR_NAME → YOUR_NAME (resolved automatically), or
    • your 17-digit SteamID64 (steamcommunity.com/profiles/7656…; or look it
      up at https://steamid.io).

    With STEAM_ID set you can just ask "my wishlist / library"; without it,
    give the agent a SteamID64 each time (use resolve_vanity_url to convert a name).

  3. Make your profile public (for your own library/achievements): Steam →
    profile → Edit Profile → Privacy Settings → set My profile and
    Game details to Public.

The key and Steam ID go in your MCP client config (the env block above). See
docs/clients.md for per-client examples. Never commit them.

Tools

Key: – no credentials · K Steam Web API key.

Tool Key Purpose
search_games – Find games by title → appid (with price, Metacritic, type) — up to 100 matches
get_game – Store details by appid or name: price, genres, platforms, Metacritic, age rating, DLC, requirements
get_items – Batch store card (price, review %, Deck/SteamOS/Machine/Frame compat, native platforms, tags) — up to 50 appids
discover_games – Find games catalog-wide by discount, recency, Deck/SteamOS/Machine/Frame, platform, tags, rating
get_game_reviews – Review summary + the most helpful (any window up to a year) or newest reviews
get_review_histogram – Review trend over time (history + recent)
get_prices – Batch current price/discount — up to 250 appids
get_specials – Steam front-page discounts
get_featured – Featured sections (top sellers, new releases, …)
get_game_news – Recent news, or only the developer's posts / patch notes
get_global_achievements – Global achievement unlock rates (rarity) — top 200
get_current_players – Live concurrent player count
get_charts – What's popular now: weekly top sellers (global or per country, any past week), most played (also on Steam Deck), live concurrent top 100 (ranks + appids)
get_wishlist – A player's wishlist — appids, or full cards + on-sale filter with include_details (public profiles)
get_followed_games – A player's followed games (Steam's "follow" feature, separate from the wishlist) — appids (public profiles)
get_game_achievements K Achievement list (names, descriptions) + rarity — first 150, definition order
resolve_vanity_url K Custom profile name → SteamID64
get_player_summary K Player public profile (incl. Steam level)
get_player_bans K VAC/game/community/economy ban status (works even on private profiles)
get_owned_games K A player's games + playtime (50 by playtime, limit widens to 300 and sort flips which end is kept; check_appids reliably checks specific appids past that)
get_recently_played K Games played in the last two weeks (top 50 by recent playtime)
get_recommended_games K Personalized picks from playtime-weighted tags + review quality, excluding owned games
get_player_achievements K A player's achievement progress in a game — achievement list capped at top 200, unlocked first
get_friend_list K A player's friends — name, online state, current game (public friends list)
find_friends_who_own K Which friends own given appid(s) + their playtime — each friend's FULL library, first 200 friends (friends_checked)
compare_players K Games two players both own, with each one's playtime — checks each player's FULL library, not just top 50

Two tiers. Store/search + discovery tools (store/api.steampowered.com)
need no credentials — including catalog-wide discovery (discover_games:
deals, new releases, Deck / SteamOS / Machine / Frame compatibility, tags, rating) and batch
price/review checks (get_items).
Player tools need a free
STEAM_API_KEY and a public profile; they return a clear message when the
key is unset. The two exceptions are get_wishlist and get_followed_games,
marked – above: they work with no key at all. Set STEAM_ID (a SteamID64
or vanity name — a vanity name resolves without a key too) to make those tools
default to you, so "my wishlist / library" works without passing an ID each time.

No third-party services: deal discovery and reviews come from Steam's own
(keyless) store APIs. SteamDB is not used (no public API + scraping disallowed).
Steam has no price-history API, so that isn't offered. Not affiliated with Valve.

Prompts

Guided one-shot prompts that orchestrate several tools for a common question.
Use these when your client exposes MCP prompts, instead of describing the steps yourself:

Prompt Args What it does
what_should_i_play steamid, budget, tags (all optional) Recommends catalog games from your library/taste, excluding what you own
is_it_worth_buying game (title or appid, optional, autocompletes; asks if omitted) Price, review trend and Steam Deck compatibility → a buy/wait/skip verdict
deals_digest min_discount, min_review, tags (all optional) A curated list of well-reviewed discounted games

Develop

npm install
npm run build        # type-check + bundle to dist/index.js
npm test             # node:test (mocked, offline)
npm run lint
npm run format
npm run check:api    # live upstream health-check (key-gated checks need STEAM_API_KEY; a public STEAM_ID verifies player fields)
npm run inspector    # run under the MCP Inspector

Runtime requires Node ≥ 20.11. Contributor/agent guidance:
AGENTS.md.
Security policy: SECURITY.md.
Per-client config and all tunables:
docs/clients.md.

Updating

  • npx: unpinned npx -y steam-games-mcp fetches the latest on the next run.
  • .mcpb bundle: download the new bundle from the releases page and reinstall.
  • From source: git pull && npm ci && npm run build.

Privacy Policy

steam-games-mcp runs entirely on your own machine and collects no data of
its own. See PRIVACY.md for exactly what it sends to Steam and
what (if anything) it stores locally.

License

MIT © Grinv

Yorumlar (0)

Sonuc bulunamadi