CS2 RCON MCP

Un servidor para gestionar servidores de Counter-Strike 2 usando el protocolo RCON.

Documentación

CS2 RCON MCP

Python MCP Compatible License: MIT

Un servidor de Protocolo de Contexto de Modelo para la gestión de CS2 RCON.

Descripción

Este proyecto proporciona una interfaz de servidor de Protocolo de Contexto de Modelo (MCP) para gestionar servidores de juego CS2 mediante RCON. Permite el control remoto y la monitorización de servidores CS2 a través de un protocolo estandarizado.

CS2 RCON MCP Demo

Características

  • Gestiona tu servidor CS2 en lenguaje natural
  • Ejecución de comandos RCON
  • Gestión de mapas del taller (alojar, listar, cambiar) - Explorar mapas del taller
  • Comunicación basada en SSE
  • Soporte para Docker

Herramientas disponibles

HerramientaDescripción breve
rconEjecuta cualquier comando RCON
statusObtiene el estado actual del servidor
list_workshop_mapsLista todos los mapas del taller en el servidor
host_workshop_mapAloja un mapa del taller por su ID
workshop_changelevelCambia el mapa a un mapa del taller dado

Instalación

Variables de entorno

  • HOST: IP del servidor CS2
  • SERVER_PORT: Puerto del servidor CS2
  • RCON_PASSWORD: Contraseña de RCON

Docker (recomendado)

Extrae la imagen de Docker del Registro de Contenedores de GitHub:

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

Variables de entorno de Docker

Cuando se ejecuta con Docker, se pueden establecer las variables de entorno de dos maneras:

  1. Directamente en el comando:

    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. Usando un archivo .server-env: Crea un archivo llamado .server-env con el siguiente contenido:

    HOST=your_server_ip
    SERVER_PORT=your_server_port
    RCON_PASSWORD=your_password
    

    Luego ejecuta el contenedor así:

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

Esto ofrece a los usuarios un método alternativo para establecer variables de entorno, facilitando la gestión de información sensible como contraseñas.

Conexión desde Visual Studio Code (GitHub Copilot)

Para configurar Visual Studio Code y que funcione con el servidor MCP, sigue estos pasos:

  1. Inicia el servidor MCP: Asegúrate de que tu servidor MCP esté en ejecución antes de intentar conectarte desde VS Code.

  2. Abre Visual Studio Code: Inicia VS Code y asegúrate de tener la extensión de GitHub Copilot instalada y configurada.

  3. Configura GitHub Copilot:

    • Cambia el modo de "Preguntar" a modo "Agente".
  4. Añade la configuración del servidor MCP:

    • Haz clic en el icono de la caja de herramientas en la esquina superior izquierda del mensaje de Copilot.
    • Selecciona "Añadir servidor MCP" y elige la opción para HTTP - eventos enviados por el servidor.
  5. Introduce la URL del servidor:

    • Para la URL, introduce: http://localhost:8080/cs2server/sse. Este es el endpoint para la conexión SSE del servidor MCP.

Alternativa: Conexión desde Cursor (o cualquier otro cliente MCP)

  1. Inicia el servidor MCP
  2. Configura los ajustes MCP de Cursor creando o actualizando ~/.cursor/mcp.json:
    {
      "mcpServers": {
        "cs2server": {
          "url": "http://localhost:8080/cs2server/sse"
        }
      }
    }
    
  3. En Cursor, abre el panel MCP (generalmente en la barra lateral)
  4. El servidor debería conectarse automáticamente usando la URL configurada

Una vez conectado, puedes gestionar tu servidor en lenguaje natural.

Ejemplos de comandos:

  1. "Añade 5 bots al servidor y comienza una partida competitiva en de_dust2"
  2. "¿Cuál es el estado actual del servidor? ¿Cuántos jugadores están conectados y en qué mapa estamos?"

¡Felices frags! 😊