Skip to main content
Glama
goldsrc-query-mcp

goldsrc-query-mcp

goldsrc-query-mcp

npm version license CI E2E

Ein MCP-Server, der KI-Assistenten ermöglicht, GoldSrc-Spielserver (Half-Life, Counter-Strike 1.6 usw.) mithilfe der goldsrc-query-Bibliothek abzufragen.


Werkzeuge

Werkzeug

Beschreibung

ping

Roundtrip-Latenz in Millisekunden

get_server_info

Servername, Karte, Spieleranzahl, VAC-Status und mehr

get_players

Aktuelle Spielerliste mit Namen, Punktzahlen und Spielzeit

get_rules

Alle Server-Cvars

get_all

Serverinformationen, Spielerliste und Regeln in einem Aufruf

send_rcon

Sendet einen einzelnen RCON-Befehl und gibt die Antwort zurück

send_rcon_batch

Sendet mehrere RCON-Befehle über eine einzelne authentifizierte Verbindung


Related MCP server: Steam MCP Server

Installation

npx goldsrc-query-mcp

Oder global installieren:

npm install -g goldsrc-query-mcp

Anforderungen: Node.js >=20.12.0


Verwendung

Transporte

Der Server unterstützt drei Transporte, die über die Umgebungsvariable MCP_TRANSPORT (oder das --http-Flag für HTTP) ausgewählt werden.

stdio (Standard)

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 und MCP_TLS_KEY müssen beide gesetzt sein; der Server beendet sich mit einem Fehler, wenn einer fehlt.

Claude Desktop

Fügen Sie zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

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

Beispielaufforderungen

  • "Welche Karte läuft auf 192.168.1.10:27015?"

  • "Wie viele Spieler sind auf dem Server unter cs.example.com?"

  • "Zeig mir alle Cvars auf meinem Server."

  • "Führe sv_gravity 800 auf meinem Server unter 192.168.1.10 mit dem Passwort secret aus."

  • "Kicke alle Bots und ändere die Karte auf de_dust2 auf meinem Server."


Werkzeugreferenz

Alle Werkzeuge akzeptieren address (erforderlich), port (Standard 27015) und timeout (Standard 3000 ms).

ping

Gibt die Roundtrip-Latenz in Millisekunden zurück.

get_server_info

Gibt Servermetadaten als JSON zurück – Name, Karte, Spieleranzahl, VAC-Status, Servertyp, Umgebung und optionale EDF-Felder.

get_players

Gibt die Spielerliste als JSON zurück – Index, Name, Punktzahl und Dauer (Sekunden im Spiel) pro Spieler.

get_rules

Gibt alle Server-Cvars als JSON zurück – Gesamtanzahl und eine Liste von { name, value }-Paaren.

get_all

Gibt Serverinformationen, Spielerliste und Regeln in einem einzigen Aufruf zurück. Verwenden Sie dies anstelle von separaten Aufrufen von get_server_info, get_players und get_rules.

send_rcon

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

Sendet einen einzelnen RCON-Befehl und gibt die Serverantwort zurück.

send_rcon_batch

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

Sendet mehrere RCON-Befehle über eine einzelne authentifizierte Verbindung. Gibt ein Array von { command, response }-Paaren zurück. Verwenden Sie dies anstelle von send_rcon, wenn Sie mehr als einen Befehl ausführen.

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