GamePick MCP (게임픽 MCP)

Steam 라이브러리, 플레이타임, 할인 후보, 리뷰 데이터를 활용해 사용자가 지금 플레이할 게임과 구매할 게임을 고르도록 돕는 개인화 게임 큐레이터 MCP 서버입니다.

핵심 보안 설계

이 버전은 무상태(stateless) MCP 서버입니다.

• Steam API Key를 코드에 하드코딩하지 않습니다.

• 사용자의 Steam API Key를 서버 파일, DB, .env에 저장하지 않습니다.

• 개인 Steam 라이브러리 접근이 필요한 Tool은 steam_api_key와 player를 입력값으로 받습니다.

• 같은 대화에서 반복 입력을 줄이는 역할은 서버가 아니라 GAMEPICK_SKILL.md의 스킬 지침이 담당합니다.

• 서버 환경변수 STEAM_API_KEY도 선택적으로 지원하지만, GitHub에는 절대 실제 Key를 올리지 않습니다.

Related MCP server: Steam MCP Server

Skill 기반 사용 흐름

GAMEPICK_SKILL.md에는 다음 지침이 들어 있습니다.

1. 사용자가 같은 대화 안에서 Steam API Key를 제공했다면 이후 GamePick MCP Tool 호출에 steam_api_key로 함께 전달합니다.

2. 사용자가 같은 대화 안에서 SteamID64 또는 Steam 프로필명을 제공했다면 이후 Tool 호출에 player로 함께 전달합니다.

3. 둘 중 하나가 없으면 먼저 사용자에게 요청합니다.

4. Steam API Key 전체를 응답에 다시 노출하지 않습니다.

5. 서버에 API Key가 저장되었다고 말하지 않습니다. 해당 요청 처리에만 사용된다고 안내합니다.

PlayMCP 제출 양식 대응

모든 Tool에는 다음 항목을 명시했습니다.

• description: 모든 설명에 서비스명 GamePick MCP(게임픽 MCP) 포함

• annotations: 모든 Tool에 title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint 정의

Tools

개인화 Tool 호출 예시

{
  "steam_api_key": "사용자 Steam Web API Key",
  "player": "SteamID64 또는 Steam 프로필명"
}

API Key 또는 player가 없으면 Tool은 실행을 거부하고 필요한 입력을 요청합니다.

실행

docker build -t gamepick-mcp .
docker run --rm -p 8000:8000 gamepick-mcp

기본 MCP 엔드포인트:

http://localhost:8000/mcp

서버 환경변수 방식도 선택적으로 지원합니다. 이 경우 steam_api_key 입력이 없으면 서버 환경변수 값을 사용합니다.

docker run --rm -p 8000:8000 -e STEAM_API_KEY="your_steam_web_api_key_here" gamepick-mcp

로컬 실행

Windows:

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python server.py

macOS/Linux:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python server.py

환경변수

의존성

requirements.txt는 제출용 Dockerfile 형식에 맞춰 아래 3개만 사용합니다.

fastmcp
uvicorn
starlette

주의사항

• Steam 라이브러리 조회는 사용자의 Steam 프로필 게임 세부 정보 공개 설정에 영향을 받습니다.

• 할인 정보는 Steam Store 공개 featured/store 엔드포인트 기반이므로 전체 Steam 할인 목록 전수조사를 보장하지 않습니다.

• GitHub에는 .env를 올리지 말고 .env.example만 올리세요.

• 공개 서버에서 사용자별 API Key를 서버에 저장하지 않도록 설계했습니다.