Skip to content

v1.0.0: 첫 번째 공식 릴리스

Choose a tag to compare

View all tags
@deuxksy deuxksy released this 23 Feb 20:37
· 24 commits to main since this release
v1.0.0
59b4d06

🎮 mcp-server-steam v1.0.0

FastMCP 3.0 beta2를 사용하여 Steam Web API와 통합하는 종합 MCP(Model Context Protocol) 서버의 첫 번째 공식 릴리스입니다.

✨ 주요 기능

사용자 프로필 및 통계

  • 프로필 정보 (닉네임, 아바타, 계정 상세)
  • 친구 목록 조회
  • 소유 게임 라이브러리 전체 조회
  • 플레이시간 데이터 분석
  • 최근 플레이한 게임 목록
  • Steam 레벨 확인
  • 업적 진행상황 조회

게임 정보 및 스토어

  • 게임 상세 정보 및 메타데이터
  • 스토어 가격 및 할인 정보 확인
  • 게임 뉴스 및 업데이트 확인
  • Steam에서 게임 검색
  • 특정 게임의 업적 데이터 및 스키마
  • 전체 플레이어 업적 달성률 통계

커뮤니티 기능

  • Steam 워크샵 아이템 조회 및 상세 정보
  • 사용자 리뷰 확인
  • VAC 및 게임 밴 상태 조회

유틸리티

  • 커스텀 프로필 URL(Vanity URL)을 Steam ID로 변환

📦 설치 방법

1. 저장소 클론

git clone https://github.com/deuxksy/mcp-server-steam.git
cd mcp-server-steam

2. uv로 의존성 설치

uv sync

3. Steam Web API 키 발급

4. 환경 설정

cp .env.example .env

.env 파일에 API 키 추가:

STEAM_API_KEY=your_api_key_here

🚀 사용 방법

Claude Desktop 설정

{
  "mcpServers": {
    "steam": {
      "command": "uv",
      "args": ["run", "python", "/path/to/mcp-server-steam/server.py"],
      "env": {
        "STEAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

서버 실행:

uv run python server.py

🛠️ 사용 가능한 도구

프로필 도구

  • get_user_profile - Steam 사용자 프로필 조회
  • get_friends_list - 친구 목록 조회
  • get_owned_games - 소유한 모든 게임 조회
  • get_recently_played_games - 최근 플레이한 게임 조회
  • get_steam_level - Steam 레벨 조회
  • get_player_achievements - 특정 게임의 업적 진행상황 조회

게임 도구

  • get_game_details - 스토어에서 게임 정보 조회
  • get_game_news - 게임 뉴스 및 업데이트 조회
  • get_global_achievement_percentages - 전체 업적 통계 조회
  • search_games - Steam에서 게임 검색
  • get_game_schema - 업적 및 통계 스키마 조회

커뮤니티 도구

  • get_workshop_items - Steam 워크샵 아이템 조회
  • get_workshop_item_details - 워크샵 아이템 상세 정보
  • get_user_reviews - 게임 사용자 리뷰 조회
  • get_player_bans - VAC 및 게임 밴 상태 조회

유틸리티 도구

  • resolve_vanity_url - Vanity URL을 Steam ID로 변환

📋 요구 사항

  • Python 3.10 이상
  • FastMCP 3.0 beta2
  • uv (Python 패키지 관리자)
  • Steam Web API 키

🔄 주요 변경사항

v1.0.0 (2026-02-24)

  • FastMCP 3.0 beta2 기반 MCP 서버 구현
  • Steam Web API 전체 통합
  • 사용자 프로필 및 게임 라이브러리 지원
  • 업적 및 통계 추적 기능
  • Steam 워크샵 통합
  • 속도 제한(Rate Limiting) 구현
  • 한국어 전체 문서화

🐛 알려진 문제

  • Steam API 속도 제한: 분당 100회 요청 제한 (자동 백오프 구현됨)

🔗 참고 링크

📄 라이선스

MIT License - 자세한 내용은 LICENSE 파일을 참조하세요

다운로드: 이 릴리스에 포함된 소스 코드 아카이브(tar.gz, zip)를 다운로드하여 사용하세요.

Assets 4
Loading