goldsrc-query-mcp
goldsrc-query-mcp
AIアシスタントがGoldSrcゲームサーバー(Half-Life、Counter-Strike 1.6など)をgoldsrc-queryライブラリを使ってクエリできるようにするMCPサーバーです。
ツール
ツール | 説明 |
| 往復レイテンシ(ミリ秒) |
| サーバー名、マップ、プレイヤー数、VACステータスなど |
| 現在のプレイヤーリスト(名前、スコア、ゲーム内時間) |
| すべてのサーバーcvars |
| サーバー情報、プレイヤーリスト、ルールを1回の呼び出しで取得 |
| 単一のRCONコマンドを送信し、応答を返す |
| 単一の認証済み接続で複数の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フラグ)で選択される3つのトランスポートをサポートしています。
stdio(デフォルト)
node dist/index.js
# or
npx goldsrc-query-mcpHTTP
MCP_TRANSPORT=http MCP_PORT=3000 node dist/index.js
# shorthand flag
node dist/index.js --httpHTTPS
MCP_TRANSPORT=https MCP_PORT=443 MCP_TLS_CERT=cert.pem MCP_TLS_KEY=key.pem node dist/index.jsMCP_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(デフォルト3000ミリ秒)を受け付けます。
ping
往復レイテンシをミリ秒で返します。
get_server_info
サーバーメタデータをJSONで返します - 名前、マップ、プレイヤー数、VACステータス、サーバータイプ、環境、オプションのEDFフィールド。
get_players
プレイヤーリストをJSONで返します - 各プレイヤーのインデックス、名前、スコア、滞在時間(ゲーム内秒数)。
get_rules
すべてのサーバーcvarsをJSONで返します - 総数と{ name, value }ペアのリスト。
get_all
サーバー情報、プレイヤーリスト、ルールを1回の呼び出しで返します。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 toolsget_allGet AllARead-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 PlayersARead-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 RulesARead-only
Get all server cvars. Use to inspect server configuration.
Inputs: address (required), port, timeout.
get_server_infoGet Server InfoARead-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.
pingPingARead-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 RCONADestructive
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 BatchADestructive
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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Search game servers (Minecraft, Rust, FiveM and more), see votes and stats, edit your own listing.
Manage game servers, configurations, players, and groups through the GameServerApp MCP server.
Health checks for public MCP servers: status, latency, tools, and uptime.
Trust, freshness, policy, and discovery layer for public MCP servers.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Minecraft server management via RCON: execute commands, list players, get server info, manage whitelist and operators.91MIT
- AlicenseAqualityBmaintenanceEnables interaction with Steam: search games, get store details, reviews, prices, discounts, news, and player profiles, libraries, and achievements via the Steam Web API.26268 npm5MIT
- AlicenseAqualityDmaintenanceEnables control and inspection of a Factorio 2.0 server via RCON, with tools for administration, player management, game state queries, and Lua execution.19ISC
- AlicenseNot gradedqualityDmaintenanceEnables 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.1MIT