Steam & Game Server MCP

Steam 프로필, 게임 라이브러리, 동시 접속자, 게임 서버 상태를 조회·진단·관리하는 MCP(Model Context Protocol) 서버입니다.

Cursor, Claude Desktop, VS Code, Windsurf 등 MCP 클라이언트에서 사용합니다.

1. 소개

2. 요구사항

• Node.js 18+
• MCP 클라이언트 (Cursor, Claude Desktop, VS Code, Windsurf 등)
• `STEAM_API_KEY` — Steam API 키 발급

> MCP 설정의 `env`에 환경변수를 넣는 것을 기준으로 합니다. `.env`는 로컬 개발 시에만 사용합니다.

3. MCP 설정

3.1 표준 설정 (npx)

# 사전 설치 없이 npx로 최신 버전 실행 (최초 1회 실행 시 패키지를 내려받습니다)
npx steam-game-server-mcp@latest --help

{
  "mcpServers": {
    "steam-game-server": {
      "command": "npx",
      "args": ["steam-game-server-mcp@latest"],
      "env": {
        "STEAM_API_KEY": "your_key",
        "STEAM_ID": "your_steam_id",
        "STEAM_MCP_SERVERS_PATH": "C:/path/to/servers.json"
      }
    }
  }
}

• `STEAM_MCP_SERVERS_PATH`: 미설정 시 `./servers.json` 사용. 둘 다 없으면 Steam 도구만 동작

3.2 Cursor

1. `Settings` → `MCP` → `Add new MCP Server`

2. 위 JSON 입력 (또는 `command`를 `node`, `args`를 `["/path/to/dist/index.js"]`로 로컬 빌드 경로 지정)

3.3 env 키별 요약

3.4 사용 시나리오별 env 세트

4. MCP 도구 (26개)

Steam (7개)

Game Server (3개)

Monitoring (6개)

Admin (4개) — RCON 필요

Inventory (4개)

Discovery (1개)

Log (1개)

5. 테스트

자동 테스트 (Vitest)

npm test

• config/servers, server-tools, inventory-tools, admin-tools, discovery-tools, log-tools, steam-tools, rcon/client — 총 76개

수동 테스트

• Game Server 조회: 공개 Minecraft 서버(Hypixel 등)를 servers.json에 등록 후 `game_server_query`, `server_overview` 호출
• RCON: `npm run rcon:server`로 mock 서버 실행 → `STEAM_MCP_SERVERS_PATH=./test/rcon/servers.rcon-test.json SERVER_RCON_PASSWORD=test123 npm run rcon:test -- my-rust status`

6. 주의사항 및 구현 제약

에러 조건

• gamedig type: `type`은 GAMES_LIST와 일치해야 함
• RCON: `rcon.enabled: true`인데 `passwordEnv`에 해당하는 env가 없으면 `"RCON not configured for this server."` 반환
• STEAM_API_KEY: 미설정 시 Steam 도구 전부 `"STEAM_API_KEY 환경 변수를 확인하세요."` 반환

구현 제약

7. 개발 셋업

npm install
npm run build
npm run dev   # 또는 npm start

로컬 실행 시 `.env`에 `STEAM_API_KEY`, `STEAM_ID`, RCON 비밀번호 등을 설정합니다.