Skip to main content

RustMCP

MCP server that lets an AI agent (Claude, Cursor, Codex) manage a Rust game server over WebRCON.

Tools

Tool What it does
server_info serverinfo: hostname, players, fps, map
list_players playerlist as JSON
console_tail last N console lines
chat_tail last N chat messages
find_command search console commands and variables (find <query>)
say message to global chat
reload_plugin o.reload / c.reload, returns compile errors (Oxide or Carbon is detected automatically)
rcon any command; off unless ALLOW_RAW_COMMANDS=true

Even with ALLOW_RAW_COMMANDS=true, commands like quit, restart, ownerid, kickall, harmony.load and changes to rcon.* are blocked.

Requirements

  • uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  • A Rust server with rcon.web 1 (the default)

Setup

Replace the IP, port and password with your server's RCON settings.

Claude Code

claude mcp add RustMCP -e RCON_HOST=127.0.0.1 -e RCON_PORT=28016 -e RCON_PASSWORD=your-rcon-password -- uvx RustMCP

Codex

codex mcp add RustMCP --env RCON_HOST=127.0.0.1 --env RCON_PORT=28016 --env RCON_PASSWORD=your-rcon-password -- uvx RustMCP

Cursor, Claude Desktop and other clients

Add this to the client's MCP config file:

{
  "mcpServers": {
    "RustMCP": {
      "command": "uvx",
      "args": ["RustMCP"],
      "env": {
        "RCON_HOST": "127.0.0.1",
        "RCON_PORT": "28016",
        "RCON_PASSWORD": "your-rcon-password"
      }
    }
  }
}

Configuration

Variable Required Description
RCON_HOST yes Server IP or hostname
RCON_PORT yes RCON port (rcon.port)
RCON_PASSWORD yes RCON password (rcon.password)
ALLOW_RAW_COMMANDS no true enables the rcon tool. Default false

Good to know

  • Rust refuses a new RCON connection from the same IP within 1 second (rcon.connectioncooldown), so commands run one after another with a short pause.
  • 5 wrong passwords get your IP banned from RCON for 5 minutes (rcon.maxpasswordfailures). RustMCP never retries a rejected login.
  • Chat, console and player names are written by players. The agent is told to treat them as data, but keep ALLOW_RAW_COMMANDS=false unless you need it.

License

MIT

Metadata

Release files for RustMCP 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for RustMCP 0.1.0
File Size Uploaded Provenance Actions
rustmcp-0.1.0.tar.gz 7.1 kB Without provenance Details for rustmcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for RustMCP 0.1.0
File Interpreter ABI Platform Actions
rustmcp-0.1.0-py3-none-any.whl Python 3 none any Details for rustmcp-0.1.0-py3-none-any.whl

Total release size: 15.7 kB

Release files / rustmcp-0.1.0.tar.gz

Download URL rustmcp-0.1.0.tar.gz
Size 7.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8d662d335a2953e1e15d4748bea43bf867e0c3519ed6e54618b16ff0e9f3ddbf
BLAKE2b-256 checksum
How to use checksums
2f63a1dee4ef3f85f9e1bb681b5cab5e1ca947eef883885cf467ce5fdf379520
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / rustmcp-0.1.0-py3-none-any.whl

Download URL rustmcp-0.1.0-py3-none-any.whl
Size 8.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ec42d2010b3c3e9a0fa449f11466b132c5fcbc402d3f39f846a6f088980a67cf
BLAKE2b-256 checksum
How to use checksums
a78c17366d158ce5f8a4b7ed632ab20128d44de13fafee42b2527ea63b1afe45
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for RustMCP 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page