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에서 실시간으로 답변을 가져옵니다.

왜 필요한가

Steam Web API는 강력하지만 방대합니다. 수십 개의 인터페이스, 일관되지 않은 데이터 구조, 64비트 SteamID, 문서화되지 않은 스토어 API, 그리고 플레이어 관련 기능에는 필수 키가 필요합니다. steam-mcp는 유용한 부분을 LLM 친화적이고 토큰 효율적인 응답을 반환하는 작고 잘 문서화된 워크플로 중심 MCP 도구 세트로 감쌉니다.

Related MCP server: Steam MCP Server

빠른 시작

플레이어/프로필 도구에는 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를 참조하세요.

구성

도구

전체 생성 도구 참조는 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의 상표입니다.