Skip to main content
Glama

steam-mcp

MCP サーバーで、Steam Web API をあらゆる AI ハーネス(Claude Desktop、Claude Code、Cursor、Cline、Windsurf、または Model Context Protocol を話すあらゆるもの)に公開します。

アシスタントに 「Team Fortress 2 に何時間費やしましたか?」、「友人が所有している最もプレイされているゲームは何ですか?」、「Baldur's Gate 3 のレビューを要約してください」 のようなことを尋ねると、Steam からライブで回答を取得します。

CI License: MIT Python 3.10+


なぜ

Steam Web API は強力ですが、広大で複雑です。数十のインターフェース、一貫性のない形状、64 ビットの SteamID、文書化されていないストア API、そしてプレイヤー関連のすべてに必須のキーがあります。steam-mcp は、LLM に優しくトークン効率の良いレスポンスを返す、小さくて文書化された ワークフロー指向 の MCP ツールセットの背後に、有用な部分をラップします。

Related MCP server: mcp-server-steam

クイックスタート

プレイヤー/プロフィールツールには Steam Web API キーが必要です。https://steamcommunity.com/dev/apikey で(無料で)取得できます。ストアツール(アプリ詳細、レビュー、検索)は キーなし で動作します。

インストール不要で、uv を使って GitHub から直接実行できます(現在動作します — PyPI リリースは準備中です):

STEAM_API_KEY=xxxxxxxx uvx --from git+https://github.com/rachittshah/steam-mcp steam-mcp

またはソースからインストールします:

uv pip install git+https://github.com/rachittshah/steam-mcp
# once published to PyPI: uv pip install steam-mcp

Claude Desktop / Claude Code

MCP 設定(claude_desktop_config.json、または Claude Code の場合は .mcp.json)に追加します:

{
  "mcpServers": {
    "steam": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rachittshah/steam-mcp", "steam-mcp"],
      "env": { "STEAM_API_KEY": "your-key-here" }
    }
  }
}

(PyPI リリース後、args は ["steam-mcp"] に簡略化されます。)

Cursor / Cline / Windsurf

MCP サーバーコマンドを同じ uvx --from git+... steam-mcp の呼び出しに指定し、環境に STEAM_API_KEY を設定します。クライアントごとの手順は docs/clients.md を参照してください。

設定

変数

必須

デフォルト

説明

STEAM_API_KEY

プレイヤーツール用

—

Steam Web API キー。

STEAM_MCP_TIMEOUT

不要

20

HTTP リクエストのタイムアウト(秒)。

STEAM_MCP_LANGUAGE

不要

english

ローカライズされたストアレスポンスの言語。

STEAM_MCP_COUNTRY

不要

US

ストア価格の ISO 国コード。

ツール

完全な生成済みツールリファレンスは docs/tools.md にあります。ハイライト:

  • アイデンティティ — resolve_vanity_url、get_player_summary、get_player_bans、get_steam_level

  • ライブラリ — get_owned_games、get_recently_played_games、get_friend_list

  • 実績と統計 — get_player_achievements、get_game_schema、get_global_achievement_percentages、get_current_player_count

  • ストア — get_app_details、get_app_reviews、search_store

  • ニュース — get_news_for_app

プロンプト例

接続したら、アシスタントに次のように試してみてください:

  • 「今 Counter-Strike 2 をプレイしている人は何人ですか?」 → search_store → get_current_player_count

  • 「Team Fortress 2 で最も珍しい実績は何ですか?」 → get_global_achievement_percentages

  • 「Elden Ring の最近のレビューを要約してください。」 → search_store → get_app_reviews

  • 「steamcommunity.com/id/gabelogannewell のプロフィールは誰のもので、何をプレイしていますか?」 → get_player_summary

  • 「私の最もプレイされた 5 つのゲームは何ですか?」(SteamID が必要)→ get_owned_games

  • 「Dota 2 の最近のパッチノートはありますか?」 → get_news_for_app

開発

git clone https://github.com/rachittshah/steam-mcp
cd steam-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
ruff check . && mypy src && pytest

貢献

貢献歓迎 — CONTRIBUTING.md を参照してください。

ライセンス

MIT © Rachitt Shah。Valve Corporation とは提携しておらず、承認も受けていません。Steam および Steam ロゴは Valve Corporation の商標です。

Available Tools

15 tools
get_app_detailsA
Read-onlyIdempotent

Get full store details for a game/app by appid.

Returns type, description, developers/publishers, release date, price, genres, platforms, Metacritic score, and review recommendation count. No API key required. Use search_store first if you only have a name.

Inputs: appid (required). Returns: result

get_app_reviewsA
Read-onlyIdempotent

Summarize store reviews for a game and show a sample of recent ones.

Returns the overall review label (e.g. "Very Positive"), positive/total counts, and a sample of recent reviews with their up/down vote and the reviewer's playtime. No API key required.

Inputs: appid (required), limit, review_type. Returns: result

get_current_player_countA
Read-onlyIdempotent

Get the number of players currently in a game, right now.

Returns the live concurrent player count for an app. Great for "how many people are playing X right now?". No API key required. Use search_store to find the appid from a game name.

Inputs: appid (required). Returns: result

get_friend_listA
Read-onlyIdempotent

List a player's friends, newest-friended first, with names.

The friend list must be public. Names are resolved in one batch call. Requires an API key.

Inputs: steam_id (required), limit. Returns: result

get_game_schemaA
Read-onlyIdempotent

Get a game's achievement and stat definitions (its schema).

Returns the game's display name, the count and names of its achievements, and any tracked stats. Use this to learn what achievements exist before checking a player's progress. Requires an API key.

Inputs: appid (required). Returns: result

get_global_achievement_percentagesA
Read-onlyIdempotent

Show how rare each achievement is across all players of a game.

Returns achievements sorted from rarest to most common (global unlock percentage). Great for "what's the rarest achievement in X?". No API key required.

Inputs: appid (required). Returns: result

get_news_for_appA
Read-onlyIdempotent

Get the latest news / patch notes for a game.

Returns recent announcements with title, source feed, date, a short excerpt, and a link. No API key required. Use search_store to find the appid from a game name.

Inputs: appid (required), count. Returns: result

get_owned_gamesA
Read-onlyIdempotent

List the games a player owns, with total playtime per game.

Returns a ranked table plus library-wide totals (game count and summed hours). The profile's game details must be public. Requires an API key.

Use sort='recent' to answer "what have they been playing lately?" and limit to control response size.

Inputs: steam_id (required), sort, limit. Returns: result

get_player_achievementsA
Read-onlyIdempotent

Show a player's achievement progress in one game.

Returns overall completion (unlocked / total) and a list of unlocked achievements with dates. The profile must be public and must own the game. Requires an API key.

Inputs: appid (required), steam_id (required). Returns: result

get_player_bansA
Read-onlyIdempotent

Check a player's VAC, game, economy, and community ban status.

Useful for trust/reputation questions. Requires an API key.

Inputs: steam_id (required). Returns: result

get_player_summaryA
Read-onlyIdempotent

Fetch a player's public profile summary.

Returns persona name, online state, profile visibility, account creation date, country, and the game they're currently playing (if public). Private profiles return limited fields. Requires an API key.

Inputs: steam_id (required). Returns: result

get_recently_played_gamesA
Read-onlyIdempotent

List games a player has played in the last two weeks.

Returns each game with its 2-week and lifetime playtime. The profile must be public. Requires an API key.

Inputs: steam_id (required), count. Returns: result

get_steam_levelA
Read-onlyIdempotent

Get a player's Steam community level. Requires an API key.

Inputs: steam_id (required). Returns: result

resolve_vanity_urlA
Read-onlyIdempotent

Resolve a Steam custom (vanity) URL name to its SteamID64.

Use this when you only have a person's custom URL name and need the numeric id that other tools consume. Requires an API key.

Returns the SteamID64 in all common formats, or a not-found message.

Inputs: vanity (required). Returns: result

search_storeA
Read-onlyIdempotent

Search the Steam store by name and return matching apps with appids.

This is the entry point for most store workflows: turn a game name the user mentioned into the appid that get_app_details, get_app_reviews, and the stats tools require. No API key required.

Inputs: term (required), limit. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: player basics, friend lists, owned games, achievements, store search, reviews, and news. The only potential overlap is between owned games and recent playtime, but the descriptions make the timeframe distinction clear.

    Naming Consistency5/5

    All tool names follow the same verb_noun snake_case pattern (get_, search_, resolve_). Even the two non-get verbs are still consistent with the pattern, resulting in a very predictable and uniform API surface.

    Tool Count5/5

    15 tools is at the upper end of the ideal range, but every tool covers a meaningful feature: player info, game stats, store details, and reviews. No tool feels redundant, and the count aligns well with Steam's broad domain.

    Completeness4/5

    The set covers the major workflows: resolving users, fetching profiles/bans/friends, listing owned and recent games, checking achievements, and getting store details/reviews/news. Minor gaps exist (e.g., no wishlist access or player review listing), but these are not dead ends for standard queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers