Cs2 Rcon MCP

A project for managing CS2 game servers through the MCP protocol, supporting RCON command execution, server status monitoring, and natural language interaction.

Games and gamification Developer tools #CS2 management #RCON control #Game server #MCP protocol .Python

rating : 2.5 points

downloads : 9.2K

update time : 2025-04-28

Open Site

What is CS2 RCON MCP?

CS2 RCON MCP is a server management tool based on the Model Context Protocol that allows users to control and monitor CS2 game servers through natural language commands. It simplifies the server management process without the need to memorize complex RCON commands.

How to use CS2 RCON MCP?

You can run the MCP server by installing the Python package or using a Docker container, and then connect through clients that support the MCP protocol (such as VS Code or Cursor) and use natural language to manage the server.

Applicable scenarios

Suitable for CS2 server administrators, e - sports event organizers, or any scenario where convenient management of CS2 servers is required, especially when you need to respond quickly or perform complex operations.

Main features

Natural language control

Use everyday language instead of professional commands to manage the server

RCON command execution

Supports the execution of all standard RCON commands

Server status monitoring

Get real - time server status and player information

SSE communication

Use Server - Sent Events (SSE) for real - time communication

Docker support

Provides a containerized deployment solution to simplify the installation process

Advantages

No need to memorize complex commands, operate using natural language

Supports multiple client connection methods

Monitor server status in real - time

Simplifies the server management process

Containerized deployment is simple and convenient

Limitations

Requires basic server configuration knowledge

Depends on network connection

Some complex operations may require specific syntax

How to use

Installation

Install the Python package via pip or use a Docker container

Configuration

Set environment variables or create a .server - env file to configure the server connection

Running

Start the MCP server

Connection

Connect to the server from clients such as VS Code or Cursor

Usage examples

Start a match

Start a 5v5 competitive match on the map de_dust2

Server maintenance

Check the server status and perform maintenance operations

Bot management

Add bots and set the difficulty

Frequently Asked Questions

How to solve the connection failure problem?

Which clients are supported?

What should I do if the command execution has no response?

How to view all available commands?

Related resources

GitHub Repository

Project source code and latest updates

CS2 RCON Documentation

Official RCON protocol documentation

MCP Protocol Description

Official description of the Model Context Protocol

🚀 CS2 RCON MCP Server

A Model Context Protocol (MCP) server interface for managing CS2 game servers, supporting the RCON protocol.

🚀 Quick Start

This project offers an MCP-based server interface for remotely controlling and monitoring CS2 game servers via RCON. It enables users to manage CS2 servers in natural language using a standardized protocol.

✨ Features

Manage CS2 servers using natural language.
Execute arbitrary RCON commands.
Monitor server status.
SSE-based communication.
Docker support.

📦 Installation

pip install -e .

💻 Usage Examples

Basic Usage

Run the Server

python -m rcon_mcp

Available Commands

rcon <command>: Execute any RCON command.
status: Get the current server status.
changelevel <map_name>: Switch the current map.
mp_warmup_end: End the warm-up phase.
mp_restartgame 1: Restart the game.
And other CS2 server commands.

Advanced Usage

Environment Variables

HOST: IP address of the CS2 server.
SERVER_PORT: Port of the CS2 server.
RCON_PASSWORD: RCON password.

Docker (Recommended)

Pull the Docker image from the GitHub container registry:

docker pull ghcr.io/v9rt3x/cs2-rcon-mcp:main

Configure Docker Environment Variables

You can set environment variables in two ways when running Docker:

Specify directly in the command:

docker run -p 8080:8080 \
  -e HOST=your_server_ip \
  -e SERVER_PORT=your_server_port \
  -e RCON_PASSWORD=your_password \
  ghcr.io/v9rt3x/cs2-rcon-mcp:main

Use the .server-env file: Create a file named .server-env with the following content:

HOST=your_server_ip
SERVER_PORT=your_server_port
RCON_PASSWORD=your_password

Then run the container:

docker run -p 8080:8080 --env-file .server-env ghcr.io/v9rt3x/cs2-rcon-mcp:main

This makes it easy to manage sensitive information such as passwords.

How to Connect from Visual Studio Code (GitHub Copilot)

To configure Visual Studio Code to communicate with the MCP server, follow these steps:

Open VS Code and ensure the GitHub Copilot plugin is installed.
Run the following command in the terminal:

python -m rcon_mcp

Open the Copilot highlighting feature in VS Code, enter the following, and press Enter:

# Configure MCP server parameters as prompted.

After completing these steps, you'll be able to connect to the MCP server via VS Code.

How to Connect in Cursor

Open Cursor and ensure the necessary plugins are installed.
Run the following command in the terminal:

python -m rcon_mcp

Use Cursor's MCP plugin to configure relevant parameters and click the "Connect" button. After completing the above steps, you'll be able to connect to the MCP server via Cursor.