MCSS MCP Server

基本能力

产品定位

MCSS MCP Server 是一个用于管理和控制 Minecraft 服务器的工具，通过 MCP 协议与客户端交互，提供服务器管理、备份管理和任务调度等功能。

核心功能

• 服务器管理
• 列出所有由 MCSS 管理的 Minecraft 服务器
• 获取特定服务器的详细信息
• 执行电源操作（启动、停止、重启、终止）
• 执行 Minecraft 命令
• 实时查看服务器控制台输出

• 更新服务器设置（名称、描述、崩溃处理等）

• 备份管理

• 列出可用备份
• 创建新的备份配置

• 按需运行备份

• 任务调度管理

• 列出计划任务
• 创建新的计划任务（命令、备份、服务器操作）
• 更新现有任务
• 删除任务
• 按需运行任务

适用场景

• 通过 MCP 客户端（如 Claude Desktop）管理 Minecraft 服务器
• 自动化 Minecraft 服务器的日常维护任务
• 实时监控和调整服务器状态

工具列表

• 服务器管理工具
• get_servers(): 列出所有服务器
• get_server_details(server_id): 获取服务器详细信息
• edit_server(server_id, ...): 更新服务器设置
• execute_server_action(server_id, action): 执行电源操作
• execute_server_command(server_id, command): 执行 Minecraft 命令

• get_server_console(server_id, lines=50): 获取控制台输出

• 备份管理工具

• get_backups(server_id): 列出备份
• create_backup(server_id, name, ...): 创建备份配置

• run_backup(server_id, backup_id): 运行备份

• 任务调度工具

• get_scheduler_tasks(server_id): 列出计划任务
• create_scheduler_task(server_id, name, ...): 创建计划任务
• update_scheduler_task(server_id, task_id, ...): 更新计划任务
• delete_scheduler_task(server_id, task_id): 删除计划任务
• run_scheduler_task(server_id, task_id): 立即运行计划任务

常见问题解答

• 依赖问题：确保 Python 3.10+ 和 MCSS Web API 已正确配置。
• 配置问题：检查 .env 文件中的 MCSS 主机、端口和 API 密钥是否正确。
• 客户端连接问题：确保 Claude Desktop 配置文件中正确指定了 MCP 服务器的路径。

使用教程

使用依赖

1. 安装 Python 3.10 或更高版本。
2. 确保 MCSS (Minecraft Server Software) 已启用 Web API。
3. 获取 MCSS Web API 的 API 密钥。
4. 安装 Claude Desktop（用于 MCP 客户端功能）。

安装教程

1. 克隆仓库： bash git clone https://github.com/largeorbitalobject/mcss-mcp-server.git cd mcss-mcp-server

2. 创建并激活虚拟环境： bash python -m venv venv # Windows .\venv\Scripts\activate # Linux/Mac source venv/bin/activate

3. 安装依赖： bash pip install mcp[cli] httpx python-dotenv

调试方式

1. 检查 .env 文件配置是否正确。
2. 运行 run_mcss_mcp.bat 启动服务器。
3. 在 Claude Desktop 中测试工具命令，如 get_servers() 是否返回预期结果。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。