add_server
servers.json에 새 서버를 추가합니다. adminToken, id, name, type, host, port 필수. query/rcon 선택.
LABSCO SUMMARY
Query, diagnose and administer, with the destructive half gated on credentials you set separately.
The operations layer goes past status polling: comparison across servers, alerting on the ones with problems, a trend built from accumulated samples, and a diagnosis pass that names a likely cause. Administration is deliberately harder to reach — RCON passwords live in environment variables named by the inventory file rather than in the file itself, and changing the inventory needs an admin token matched on both sides.
What it is
Two halves in one server: the Steam Web API for profiles, libraries and player counts, and a gamedig-based operations layer over game servers you register in a servers.json file.
What you get
- Steam lookups: a vanity URL turned into a SteamID, a profile summary, owned and recently played games, live concurrent players for an app, and an app's news and patch notes
- Game servers you have registered queried for name, map, player count and ping, plus the player list and the server's cvars
- All registered servers seen at once, one server's health diagnosed, several compared with a recommendation, and only the problem servers filtered out
- Player-count trend for a server, built from samples that accumulate as you query it
- A diagnosis pass that analyzes the cause rather than only reporting the state
- Administration over RCON: kick a player, ban one for 1h, 24h, 7d or permanently, request a restart, or run a whitelisted RCON command such as status, say, players or time
- Server inventory: add and remove entries in servers.json, list what is registered without authentication, and discover candidates through the Steam Master Server — with a dry run that proposes rather than writes
- Recent player_join, player_leave and error events pulled out of a server's log file
Requirements
Node.js 18 or newer, and a Steam Web API key in STEAM_API_KEY — without it every Steam tool returns a message telling you to check the variable. Run it with npx steam-game-server-mcp@latest over stdio, from the npm package steam-game-server-mcp, currently 1.0.1. STEAM_ID sets a default account so tools do not need one passed in. The game-server half depends on a servers.json inventory: STEAM_MCP_SERVERS_PATH points at it, falling back to ./servers.json, and with neither present only the Steam tools work. RCON passwords are never stored in that file — each server names an environment variable and the password is read from it. Adding or removing servers needs STEAM_MCP_ADMIN_TOKEN set and the same value passed as the adminToken parameter. Log reading takes a local file path only, not a remote URL or SSH. Tool descriptions are in Korean.
Setup effort
One command plus a key — npx steam-game-server-mcp@latest, then supply credentials
USE CASES
01
Finding out which of your servers is in trouble
Pull the overview of all registered servers, then filter to the ones with problems.
02
Working out why a server feels empty
Query its current state, read the player-count trend, and run the diagnosis for a likely cause.
03
Dealing with a player who is ruining a match
Read the player list, then kick or ban them for a fixed period over RCON.
04
Checking what happened before a crash
Extract the recent join, leave and error events from the server's log file.
05
Adding a server you just stood up
Discover it through the Steam Master Server, then add it to the inventory with the admin token.
06
Answering a question about a Steam account or game
Resolve the profile URL to a SteamID, then read the summary, owned games or live player count.
26 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
auto_discover_servers
Steam Master Server로 서버 후보를 탐색합니다. dryRun=true면 servers.json 미변경, 제안만 반환.
game_server_players
게임 서버의 플레이어 목록을 조회합니다.
game_server_query
servers.json에 등록된 게임 서버의 상태(이름, 맵, 인원, ping)를 조회합니다.
game_server_rules
게임 서버의 규칙(cvars)을 조회합니다.
list_servers
등록된 전체 서버 목록을 반환합니다. 인증 불필요.
log_recent_events
서버 로그에서 최근 이벤트(player_join, player_leave, error)를 추출합니다. servers.json의 logPath 필요.
remove_server
servers.json에서 serverId로 서버를 삭제합니다. adminToken 필수.
server_admin_ban_player
플레이어를 서버에서 밴합니다. duration: 1h, 24h, 7d, permanent
server_admin_kick_player
플레이어를 서버에서 추방합니다.
server_admin_rcon_command
whitelist에 등록된 RCON 명령을 실행합니다. (status, say, players, time 등)
server_admin_restart_server
서버 재시작을 요청합니다.
server_alert
문제가 감지된 서버만 필터링하여 반환합니다.
server_compare
여러 서버를 비교하고 추천합니다. serverIds 생략 시 전체 서버 비교.
server_diagnose
AI용 서버 진단(원인 분석)을 수행합니다.
server_health
단일 서버의 상태(HealthStatus)를 진단합니다.
server_overview
등록된 모든 게임 서버의 상태를 한 번에 조회합니다.
server_trend
서버의 플레이어 수 추이(트렌드)를 반환합니다. game_server_query 호출 시 샘플이 누적됩니다.
steam_discover_servers
Steam Master Server Query로 게임 서버 목록을 검색합니다. gameType, region 선택.
steam_get_app_news
앱 뉴스/패치 노트를 반환합니다.
steam_get_current_players
특정 앱의 실시간 동시 접속자 수를 반환합니다. (0: Steam 전체, 570: Dota2, 730: CS2, 440: TF2)
steam_get_owned_games
사용자가 보유한 게임 목록을 반환합니다.
steam_get_player_summary
Steam 사용자 프로필 요약(닉네임, 아바타, 상태 등)을 반환합니다.
steam_get_recently_played
최근 플레이한 게임 목록을 반환합니다.
steam_get_servers_at_address
IP 또는 IP:포트로 해당 주소의 게임 서버 목록을 조회합니다.
steam_resolve_vanity_url
Steam 커스텀 URL(예: /id/username)을 64비트 SteamID로 변환합니다.
BEFORE YOU INSTALL
What to know first
Tools you get
26 tools when we connected. Without STEAM_MCP_SERVERS_PATH or a ./servers.json, only the Steam tools work. The four server_admin_* tools need RCON configured, and add_server and remove_server need STEAM_MCP_ADMIN_TOKEN.
Requires
- npx on PATH
- Node.js 18+
- STEAM_API_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 26 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx steam-game-server-mcp@latestMCP Clients
Cursor, Claude Desktop, Other MCP clients
JSON
{
"mcpServers": {
"steam-game-server": {
"command": "npx",
"args": [
"steam-game-server-mcp@latest"
],
"env": {
"STEAM_API_KEY": "<YOUR_STEAM_API_KEY>",
"STEAM_ID": "<YOUR_STEAM_ID>",
"STEAM_MCP_SERVERS_PATH": "<YOUR_STEAM_MCP_SERVERS_PATH>"
}
}
}
}
