CS2 RCON MCP

CS2 RCON MCP

Um servidor Model Context Protocol para gerenciamento de CS2 via RCON.

Descrição

Este projeto fornece uma interface de servidor Model Context Protocol (MCP) para gerenciar servidores de jogo CS2 via RCON. Ele permite controle remoto e monitoramento de servidores CS2 por meio de um protocolo padronizado.

Recursos

• Gerencie seu servidor CS2 em linguagem natural
• Execução de comandos RCON
• Gerencie mapas do workshop (hospedar, listar, alterar) - Explore os Mapas do Workshop
• Comunicação baseada em SSE
• Suporte a Docker

Ferramentas Disponíveis

Ferramenta	Descrição Resumida
rcon	Executa qualquer comando RCON
status	Obtém o status atual do servidor
list_workshop_maps	Lista todos os mapas do workshop no servidor
host_workshop_map	Hospeda um mapa do workshop pelo seu ID
workshop_changelevel	Altera o mapa para um mapa do workshop específico

Instalação

Variáveis de Ambiente

• HOST: IP do servidor CS2
• SERVER_PORT: Porta do servidor CS2
• RCON_PASSWORD: Senha do RCON

Docker (recomendado)

Baixe a imagem Docker do GitHub Container Registry:

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

Variáveis de Ambiente no Docker

Ao executar com Docker, você pode definir as variáveis de ambiente de duas maneiras:

1. Diretamente no 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 um arquivo .server-env: Crie um arquivo chamado .server-env com o seguinte conteúdo:

   HOST=your_server_ip
   SERVER_PORT=your_server_port
   RCON_PASSWORD=your_password
   

   Em seguida, execute o contêiner assim:

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

Isso oferece aos usuários um método alternativo para definir variáveis de ambiente, facilitando o gerenciamento de informações sensíveis, como senhas.

Conexão pelo Visual Studio Code (GitHub Copilot)

Para configurar o Visual Studio Code para funcionar com o servidor MCP, siga estas etapas:

1. Inicie o Servidor MCP: Certifique-se de que seu servidor MCP esteja em execução antes de tentar conectar pelo VS Code.

2. Abra o Visual Studio Code: Inicie o VS Code e certifique-se de que a extensão GitHub Copilot esteja instalada e configurada.

3. Configure o GitHub Copilot:

   • Altere o modo de "Ask" para o modo "Agent".

4. Adicione a Configuração do Servidor MCP:

   • Clique no ícone de caixa de ferramentas no canto superior esquerdo do prompt do Copilot.
   • Selecione "Add MCP Server" e escolha a opção para HTTP - server-sent events.

5. Insira a URL do Servidor:

   • Para a URL, insira: http://localhost:8080/cs2server/sse. Este é o endpoint para a conexão SSE do servidor MCP.

Alternativa: Conexão pelo Cursor (ou qualquer outro cliente MCP)

1. Inicie o servidor MCP
2. Configure as configurações MCP do Cursor criando ou atualizando ~/.cursor/mcp.json:

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

3. No Cursor, abra o painel MCP (geralmente na barra lateral)
4. O servidor deve conectar automaticamente usando a URL configurada

Uma vez conectado, você pode gerenciar seu servidor em linguagem natural.

Exemplos de prompts:

1. "Adicione 5 bots ao servidor e inicie uma partida competitiva em de_dust2"
2. "Qual é o status atual do servidor? Quantos jogadores estão conectados e em qual mapa estamos?"

Bons frags! 😊