Skip to main content

RustMCP

PyPI Python Downloads

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.1

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.1
File Size Uploaded Provenance Actions
rustmcp-0.1.1.tar.gz 7.3 kB Without provenance Details for rustmcp-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 15.9 kB

Release files / rustmcp-0.1.1.tar.gz

Download URL rustmcp-0.1.1.tar.gz
Size 7.3 kB
Tags Source
SHA-256 checksum
How to use checksums
09589e534d702bade25c708dbae0e5ca9f207c11762ad6cd9f4b0ce77752aeee
BLAKE2b-256 checksum
How to use checksums
a5884489767b53480bb8e0cb03e6b8bb8d83941efabf49354dedd498d016dbac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

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

Download URL rustmcp-0.1.1-py3-none-any.whl
Size 8.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a7ddd7cd71279af669eaadaa2fff20e6aca5dd3818779847e9636a23e5e7813e
BLAKE2b-256 checksum
How to use checksums
761287619e55025c87aa41ab26cc952e5f0b4db2b5ca4e95da3808e021b815b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for RustMCP 0.1.1

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.1 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