Skip to main content
Glama
goldsrc-query-mcp

goldsrc-query-mcp

goldsrc-query-mcp

npm version license CI E2E

AI 어시스턴트가 goldsrc-query 라이브러리를 사용하여 GoldSrc 게임 서버(Half-Life, Counter-Strike 1.6 등)를 쿼리할 수 있게 해주는 MCP 서버입니다.


도구

도구

설명

ping

밀리초 단위의 왕복 지연 시간

get_server_info

서버 이름, 맵, 플레이어 수, VAC 상태 등

get_players

이름, 점수, 게임 내 시간이 포함된 현재 플레이어 목록

get_rules

모든 서버 cvars

get_all

서버 정보, 플레이어 목록, 규칙을 한 번에

send_rcon

단일 RCON 명령을 보내고 응답을 반환

send_rcon_batch

단일 인증 연결을 통해 여러 RCON 명령 전송


Related MCP server: Steam MCP Server

설치

npx goldsrc-query-mcp

또는 전역으로 설치:

npm install -g goldsrc-query-mcp

요구 사항: Node.js >=20.12.0


사용법

전송 방식

서버는 MCP_TRANSPORT 환경 변수(또는 HTTP의 경우 --http 플래그)를 통해 선택되는 세 가지 전송 방식을 지원합니다.

stdio (기본값)

node dist/index.js
# or
npx goldsrc-query-mcp

HTTP

MCP_TRANSPORT=http MCP_PORT=3000 node dist/index.js
# shorthand flag
node dist/index.js --http

HTTPS

MCP_TRANSPORT=https MCP_PORT=443 MCP_TLS_CERT=cert.pem MCP_TLS_KEY=key.pem node dist/index.js

MCP_TLS_CERT와 MCP_TLS_KEY를 모두 설정해야 합니다. 둘 중 하나라도 없으면 서버는 오류와 함께 종료됩니다.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가:

{
  "mcpServers": {
    "goldsrc": {
      "command": "npx",
      "args": ["goldsrc-query-mcp"]
    }
  }
}

예시 프롬프트

  • "192.168.1.10:27015 서버는 어떤 맵을 실행 중인가요?"

  • "cs.example.com 서버에는 몇 명의 플레이어가 있나요?"

  • "내 서버의 모든 cvars를 보여주세요."

  • "비밀번호 secret으로 192.168.1.10 서버에서 sv_gravity 800을 실행하세요."

  • "내 서버에서 모든 봇을 추방하고 맵을 de_dust2로 변경하세요."


도구 참조

모든 도구는 address(필수), port(기본값 27015), timeout(기본값 3000ms)을 받습니다.

ping

밀리초 단위의 왕복 지연 시간을 반환합니다.

get_server_info

서버 메타데이터를 JSON으로 반환합니다 - 이름, 맵, 플레이어 수, VAC 상태, 서버 유형, 환경 및 선택적 EDF 필드.

get_players

플레이어 목록을 JSON으로 반환합니다 - 플레이어별 인덱스, 이름, 점수 및 시간(게임 내 초).

get_rules

모든 서버 cvars를 JSON으로 반환합니다 - 총 개수와 { name, value } 쌍 목록.

get_all

서버 정보, 플레이어 목록, 규칙을 단일 호출로 반환합니다. get_server_info, get_players, get_rules를 개별적으로 호출하는 대신 이 도구를 사용하세요.

send_rcon

address:  "192.168.1.10"
password: "your_rcon_password"
command:  "status"

단일 RCON 명령을 보내고 서버 응답을 반환합니다.

send_rcon_batch

address:  "192.168.1.10"
password: "your_rcon_password"
commands: ["sv_gravity 800", "mp_friendlyfire 1", "changelevel de_dust2"]

단일 인증 연결을 통해 여러 RCON 명령을 전송합니다. { command, response } 쌍의 배열을 반환합니다. 둘 이상의 명령을 실행할 때는 send_rcon 대신 사용하세요.

Available Tools

7 tools
get_allGet AllA
Read-only

Get server info, player list, and rules in one call. Use this instead of calling get_server_info, get_players, and get_rules separately.

Inputs: address (required), port, timeout.

get_playersGet PlayersA
Read-only

Get the current player list with names, scores, and time in-game. Use to see who is on a server.

Inputs: address (required), port, timeout.

get_rulesGet RulesA
Read-only

Get all server cvars. Use to inspect server configuration.

Inputs: address (required), port, timeout.

get_server_infoGet Server InfoA
Read-only

Get server metadata: name, map, player counts, VAC status, and more. Use to get an overview of a server or check if it is online.

Inputs: address (required), port, timeout.

pingPingA
Read-only

Measure round-trip latency to a GoldSrc server. Use to check if a server is reachable and responsive.

Inputs: address (required), port, timeout.

send_rconSend RCONA
Destructive

Send a single RCON command and return the response. Use for one-off commands; prefer send_rcon_batch when sending multiple commands.

Inputs: address (required), command (required), password (required), port, +1 more.

send_rcon_batchSend RCON BatchA
Destructive

Send multiple RCON commands over a single authenticated connection. Use instead of rcon when running more than one command.

Inputs: address (required), commands (required), password (required), port, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: ping for latency, get_server_info for metadata, get_players for player list, get_rules for cvars, get_all for a combined query, and send_rcon/send_rcon_batch for command execution. The descriptions explicitly clarify when to use each, especially distinguishing the single vs. batch RCON tools and the combined vs. individual getters.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with lowercase and underscores: ping, get_*, send_*. This makes the toolset predictable and easy to navigate.

    Tool Count5/5

    With 7 tools, the server is well-scoped. Each tool serves a necessary function for querying and managing a GoldSrc server, with no redundancy or excessive bloat.

    Completeness5/5

    The toolset covers the full lifecycle of interacting with a GoldSrc server: checking reachability (ping), retrieving server info, players, and rules, fetching everything in one call, and sending RCON commands in both single and batch modes. There are no obvious gaps.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables control and inspection of a Factorio 2.0 server via RCON, with tools for administration, player management, game state queries, and Lua execution.
      19
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to programmatically control a local TF2/SourceMod game server: query live state, run commands, compile and hot-load plugins, stream telemetry, debug runtime errors, and write ephemeral scripts through the full SourceMod native API.
      1
      MIT