Skip to main content
Glama

steam-mcp

Steam Web API를 모든 AI 하네스(Claude Desktop, Claude Code, Cursor, Cline, Windsurf, 또는 Model Context Protocol을 지원하는 모든 도구)에 노출하는 MCP 서버입니다.

"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
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers