Cs2 Rcon MCP

🚀 CS2 RCON MCP 服務端

一個用於管理 CS2 遊戲服務器的 Model Context Protocol (MCP) 服務端接口，支持 RCON 協議，可讓你通過標準化協議以自然語言管理 CS2 服務器。

🚀 快速開始

該項目提供了一個基於 MCP 的服務端接口，用於通過 RCON 遠程控制和監控 CS2 遊戲服務器。藉助它，用戶能夠使用標準化協議以自然語言管理 CS2 服務器。

✨ 主要特性

• 使用自然語言管理 CS2 服務器
• 執行任意 RCON 命令
• 監控服務器狀態
• 基於 SSE 的通信
• Docker 支持

📦 安裝指南

pip install -e .

💻 使用示例

基礎用法

運行服務端

python -m rcon_mcp

可用命令

• rcon <command>: 執行任意 RCON 命令
• status: 獲取當前服務器狀態
• changelevel <map_name>: 切換當前地圖
• mp_warmup_end: 結束熱身階段
• mp_restartgame 1: 重啟遊戲
• 以及其他 CS2 服務器命令

高級用法

環境變量配置

• HOST: CS2 服務器 IP 地址
• SERVER_PORT: CS2 服務器端口
• RCON_PASSWORD: RCON 密碼

Docker（推薦）

從 GitHub 容器 registry 拉取 Docker 鏡像：

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

Docker 環境變量配置

運行 Docker 時，可以通過以下兩種方式設置環境變量：

1. 直接在命令中指定：

   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
   

2. 使用 .server-env 文件： 創建一個名為 .server-env 的文件，內容如下：

   HOST=your_server_ip
   SERVER_PORT=your_server_port
   RCON_PASSWORD=your_password
   

   然後運行容器：

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

這樣可以方便地管理敏感信息，如密碼。

如何從 Visual Studio Code (GitHub Copilot) 連接

要配置 Visual Studio Code 以與 MCP 服務端通信，請按照以下步驟操作：

1. 打開 VS Code 並確保已安裝 GitHub Copilot 插件。
2. 在終端中運行以下命令：

   python -m rcon_mcp
   

3. 在 VS Code 中打開 Copilot 突出顯示功能，輸入以下內容並按回車鍵：

   # 按照提示配置 MCP 服務端參數
   

完成這些步驟後，您將能夠通過 VS Code 連接到 MCP 服務端。

如何在 Cursor 中連接

1. 打開 Cursor 並確保已安裝必要的插件。
2. 在終端中運行以下命令：

   python -m rcon_mcp
   

3. 使用 Cursor 的 MCP 插件配置相關參數，點擊“連接”按鈕。

完成以上步驟後，您將能夠通過 Cursor 連接到 MCP 服務端。

📄 許可證

本項目採用 MIT 許可證。