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 许可证。