Skip to main content
Glama

GMod MCP Tool

MCP (Model Context Protocol) server for Garry's Mod — RCON, Lua execution, window control, screenshots, and SFTP file management.

npm License: MIT

Features

  • RCON — connect to GMod server, execute commands and Lua code

  • Screenshots — capture GMod window, zoom into specific areas, read console [Windows]

  • Window Control — focus, send keystrokes, console commands [Windows]

  • SFTP — read, write, list, delete files on remote server

Related MCP server: ark-asa-mcp

Quick Start

npx gmod-mcp

MCP Client Configuration

Claude Desktop / Claude Code / Cursor:

{
  "mcpServers": {
    "gmod": {
      "command": "npx",
      "args": ["-y", "gmod-mcp"]
    }
  }
}

With SFTP credentials via environment variables:

{
  "mcpServers": {
    "gmod": {
      "command": "npx",
      "args": ["-y", "gmod-mcp"],
      "env": {
        "SFTP_HOST": "your-server.com",
        "SFTP_PORT": "22",
        "SFTP_USER": "root",
        "SFTP_PASSWORD": "your-password"
      }
    }
  }
}

Tools (15)

RCON (4 tools)

Tool

Description

gmod_connect

Connect to GMod server via RCON

gmod_execute_rcon

Execute RCON command

gmod_execute_lua

Execute Lua code (auto-splits by statements)

gmod_disconnect

Disconnect from server

gmod_connect

Parameter

Required

Description

host

Yes

Server IP or hostname

port

No

RCON port (default: 27015)

password

Yes

RCON password

gmod_execute_rcon

Parameter

Required

Description

command

Yes

RCON command (status, say Hello!, kick Player)

Blocked commands: quit, exit, rcon_password, _restart

gmod_execute_lua

Parameter

Required

Description

code

Yes

Lua code to execute

Multi-statement code is automatically split by ; into separate lua_run calls. Local variables are converted to _G.__mcp_ globals for cross-statement persistence.

_G.plys = player.GetAll(); print(#_G.plys .. " players online")

Screenshots (3 tools) [Windows only]

Tool

Description

gmod_screenshot

Full window screenshot (PNG)

gmod_zoom

Crop + zoom specific area

gmod_read_console

Screenshot of game console

gmod_zoom

Parameter

Required

Description

x

Yes

X offset (% if 0-100, px if >100)

y

Yes

Y offset

width

Yes

Crop width

height

Yes

Crop height


Window Control (3 tools) [Windows only]

Tool

Description

gmod_focus_window

Bring GMod window to foreground

gmod_send_keys

Send keystrokes to GMod

gmod_console_command

Type command in game console [Experimental]

gmod_send_keys

Parameter

Required

Description

keys

Yes

SendKeys format string

SendKeys format: {ENTER}, {ESCAPE}, {TAB}, {F1}-{F12}, + (Shift), ^ (Ctrl), % (Alt)

gmod_console_command

Parameter

Required

Description

command

Yes

Console command (e.g. connect 1.2.3.4:27015)

Experimental: may not work correctly with non-English keyboard layouts.


SFTP (5 tools)

Tool

Description

sftp_connect

Connect to SFTP server

sftp_read_file

Read remote file

sftp_write_file

Write/upload file

sftp_list_dir

List directory contents

sftp_delete

Delete remote file

sftp_disconnect

Disconnect from SFTP

sftp_connect

Parameter

Required

Description

host

Yes

Server hostname (or SFTP_HOST env)

port

No

SSH port, default 22 (or SFTP_PORT env)

username

Yes

SSH username (or SFTP_USER env)

password

No

SSH password (or SFTP_PASSWORD env)

privateKey

No

SSH private key content

Requirements

  • Node.js >= 18

  • GMod server with RCON enabled (rcon_password in server.cfg)

  • Windows for screenshot and window control tools

  • SSH access for SFTP tools

Security

  • Destructive RCON commands (quit, exit, rcon_password) are blocked

  • Dangerous Lua functions (file.Delete, RunConsoleCommand, CompileString) trigger warnings

  • RCON password is cleared from memory after authentication

  • SFTP credentials can be passed via environment variables (no hardcoding)

Troubleshooting

Connection failed — check server is running, RCON password is correct, port is not firewalled

Lua code fails — multi-line code must use ; separators. local variables don't persist between lua_run calls (auto-converted to _G.__mcp_*)

Screenshot returns error — GMod must be running and visible (not minimized). Process name must be hl2.exe or gmod.exe

Console command types wrong characters — switch to English keyboard layout before using gmod_console_command

License

MIT

Available Tools

16 tools
gmod_connectC

Подключиться к Garry's Mod серверу через RCON

Inputs: host (required), password (required), port.

gmod_console_commandA

[Windows only] [Experimental] Выполнить команду через консоль Garry's Mod. Фокусирует окно, открывает консоль (~), вводит команду, Enter, закрывает. ВАЖНО: может работать некорректно с русской раскладкой. Для серверных команд лучше использовать gmod_execute_rcon.

Inputs: command (required).

gmod_disconnectB

Отключиться от сервера Garry's Mod

Inputs: no named parameters.

gmod_execute_luaA

Выполнить Lua код на сервере Garry's Mod. Код разбивается по точке с запятой (;) на отдельные lua_run вызовы. ВАЖНО: local переменные НЕ сохраняются между вызовами! Используйте глобальные переменные (_G.var или просто var = ...) для передачи данных между частями. Лимит ~180 символов на statement.

Inputs: code (required).

gmod_execute_rconC

Выполнить RCON команду на сервере Garry's Mod

Inputs: command (required).

gmod_focus_windowA

[Windows only] Развернуть и вывести окно Garry's Mod на передний план. Требуется запущенная игра.

Inputs: no named parameters.

gmod_read_consoleA

[Windows only] Скриншот клиентской консоли Garry's Mod. Автоматически открывает консоль (~), делает скриншот и закрывает. Возвращает PNG изображение с содержимым консоли.

Inputs: no named parameters.

gmod_screenshotA

[Windows only] Сделать скриншот окна Garry's Mod. Возвращает PNG изображение. Окно будет автоматически развёрнуто и выведено на передний план. Требуется запущенная игра.

Inputs: no named parameters.

gmod_send_keysA

[Windows only] Отправить нажатия клавиш в окно Garry's Mod. Формат SendKeys: {ENTER}, {ESCAPE}, {TAB}, + (Shift), ^ (Ctrl), % (Alt). Пример: 'status{ENTER}'

Inputs: keys (required).

gmod_zoomA

[Windows only] Скриншот + зум определённой области окна Garry's Mod. Координаты в процентах (0-100) от размера окна или в пикселях (если >100). Полезно для чтения мелкого текста, UI элементов, консоли.

Inputs: x (required), y (required), width (required), height (required).

sftp_connectC

Подключиться к серверу по SFTP для управления файлами

Inputs: host (required), username (required), port, password, +1 more.

sftp_deleteB

Удалить файл на удалённом сервере через SFTP

Inputs: path (required).

sftp_disconnectB

Отключиться от SFTP сервера

Inputs: no named parameters.

sftp_list_dirC

Список файлов в директории на удалённом сервере через SFTP

Inputs: path (required).

sftp_read_fileC

Прочитать файл с удалённого сервера через SFTP

Inputs: path (required).

sftp_write_fileC

Записать/загрузить файл на удалённый сервер через SFTP

Inputs: path (required), content (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools target clearly distinct actions (connect, execute RCON, execute Lua, screenshot, SFTP read/write). There is some overlap among gmod_execute_rcon, gmod_execute_lua, and gmod_console_command, and among the screenshot/console-reading tools, but descriptions clarify the differences well enough.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern, differentiated only by the gmod_ and sftp_ subsystem prefixes. The convention is predictable across both groups.

    Tool Count4/5

    16 tools across two distinct subsystems (GMod control and SFTP file management) is reasonable, though a few Windows-only and experimental tools make the set slightly heavy. Each tool appears to earn its place.

    Completeness4/5

    Core lifecycle operations are covered for both domains: GMod connect/execute/disconnect/screenshot/input, and SFTP connect/read/write/list/delete/disconnect. Minor gaps exist (SFTP mkdir, rename, move; direct player/server info), but agents can work around them via RCON.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for SSH remote execution, file transfer, and file editing with automatic backup/trash and ~/.ssh/config integration.
      117 npm
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      MCP server for Ark: Survival Ascended that enables RCON-based administration commands such as listing players, broadcasting messages, saving the world, and reading the game log.
      10
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      SSH-based MCP server that enables remote execution of SSH commands, file transfers, and secure server management via the MCP protocol.
      ISC