CS2 RCON MCP server

This server provides a Model Context Protocol (MCP) interface for managing CS2 game servers through RCON. It allows you to control and monitor your Counter-Strike 2 servers using natural language commands via compatible clients like GitHub Copilot and Cursor.

Features

• Manage CS2 servers using natural language commands
• Execute RCON commands seamlessly
• Workshop map management (hosting, listing, changing)
• Server status monitoring
• SSE-based communication
• Docker support

Installation and Setup

Environment Variables

You'll need to configure the following environment variables:

• HOST: Your CS2 server IP address
• SERVER_PORT: The port your CS2 server is running on
• RCON_PASSWORD: Your RCON password for server access

Docker Installation (Recommended)

The simplest way to get started is using Docker:

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

You can provide the environment variables in two ways:

Method 1: 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:latest

Method 2: Using a configuration file

Create a .server-env file with your settings:

HOST=your_server_ip
SERVER_PORT=your_server_port
RCON_PASSWORD=your_password

Then run Docker with the config file:

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

Connecting to the MCP Server

Connecting from Visual Studio Code (GitHub Copilot)

1. Start the MCP server using the instructions above
2. Open Visual Studio Code with GitHub Copilot extension installed
3. Switch Copilot from "Ask" to "Agent" mode
4. Click the toolbox icon in the Copilot prompt area
5. Select "Add MCP Server" and choose HTTP - server-sent events
6. Enter the server URL: http://localhost:8080/cs2server/sse

Connecting from Cursor

1. Start the MCP server
2. Configure Cursor by editing ~/.cursor/mcp.json:

   {
     "mcpServers": {
       "cs2server": {
         "url": "http://localhost:8080/cs2server/sse"
       }
     }
   }
   

3. Open the MCP panel in Cursor's sidebar
4. The server should connect automatically

Using the MCP Server

Once connected, you can control your CS2 server using natural language. Here are some example prompts:

• "Add 5 bots to the server and start a competitive match on de_dust2"
• "What's the current server status? How many players are connected and what map are we on?"
• "Host the workshop map with ID 2778220771"
• "Change to the map de_inferno"
• "Show me all connected players and their stats"

The MCP server interprets your natural language requests and executes the appropriate RCON commands on your CS2 server.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.