Cs2 Rcon
    Cs2 Rcon

    Cs2 Rcon

    CS2 RCON MCP - Server management tool for Counter-Strike 2

    2.9

    GitHub Stats

    Stars

    4

    Forks

    1

    Release Date

    4/18/2025

    about 2 months ago

    Detailed Description

    CS2 RCON MCP

    Python MCP Compatible License: MIT

    A Model Context Protocol server for CS2 RCON management.

    Description

    This project provides a Model Context Protocol (MCP) server interface for managing CS2 game servers via RCON. It allows remote control and monitoring of CS2 servers through a standardized protocol.

    !CS2 RCON MCP Demo

    Features

    • Manage your CS2 server in natural language
    • RCON command execution
    • Manage workshop maps (host, list, change) - Explore Workshop Maps
    • SSE-based communication
    • Docker support

    Available Tools

    | Tool | Short Description | |------|-------------------| | rcon | Execute any RCON command | | status | Get current server status | | list_workshop_maps | List all workshop maps on the server | | host_workshop_map | Host a workshop map by its ID | | workshop_changelevel | Change the map to a given workshop map |

    Installation

    Environment Variables

    • HOST: CS2 server IP
    • SERVER_PORT: CS2 server port
    • RCON_PASSWORD: RCON password

    Docker (recommended)

    Pull the Docker image from GitHub Container Registry:

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

    Docker Environment Variables

    When running with Docker, you can set the environment variables in two ways:

    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
      
    2. Using a .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 like this:

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

    This provides users with an alternative method to set environment variables, making it easier to manage sensitive information like passwords.

    Connecting from Visual Studio Code (GitHub Copilot)

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

    1. Start the MCP Server: Ensure that your MCP server is running before attempting to connect from VS Code.

    2. Open Visual Studio Code: Launch VS Code and ensure that you have the GitHub Copilot extension installed and configured.

    3. Configure GitHub Copilot:

      • Change the mode from "Ask" to "Agent" mode.
    4. Add MCP Server Configuration:

      • Click on the toolbox icon in the upper left corner of the Copilot prompt.
      • Select "Add MCP Server" and choose the option for HTTP - server-sent events.
    5. Enter the Server URL:

      • For the URL, input: http://localhost:8080/cs2server/sse. This is the endpoint for the MCP server's SSE connection.

    Alternative: Connecting from Cursor (or any other MCP-Client)

    1. Start the MCP server
    2. Configure Cursor's MCP settings by creating or updating ~/.cursor/mcp.json:
      {
        "mcpServers": {
          "cs2server": {
            "url": "http://localhost:8080/cs2server/sse"
          }
        }
      }
      
    3. In Cursor, open the MCP panel (usually in the sidebar)
    4. The server should automatically connect using the configured URL

    Once connected, you can manage your server in natural language.

    Example prompts:

    1. "Add 5 bots to the server and start a competitive match on de_dust2"
    2. "What's the current server status? How many players are connected and what map are we on?"

    Happy fragging! 😊

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.