MCSS MCP 服务器

一个通过 MCSS（Minecraft 服务器软件）API 控制 Minecraft 服务器的 MCP（模型上下文协议）服务器。此工具允许使用像 Claude Desktop 这样的 MCP 客户端无缝交互您的 Minecraft 服务器。

🌟 功能

• 服务器管理

  • 列出所有由 MCSS 管理的 Minecraft 服务器
  • 获取特定服务器的详细信息
  • 执行电源操作（启动、停止、重启、终止）
  • 执行 Minecraft 命令
  • 实时查看服务器控制台输出
  • 更新服务器设置（名称、描述、崩溃处理等）

• 备份管理

  • 列出可用备份
  • 创建新的备份配置
  • 在需要时运行备份

• 调度程序管理

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

📋 先决条件

• Python 3.10 或更高版本
• 启用 Web API 的 MCSS（Minecraft 服务器软件）
• MCSS Web API 的 API 密钥
• Claude Desktop（用于 MCP 客户端功能）

🚀 快速开始

安装

1. 克隆此仓库：

   git clone https://github.com/largeorbitalobject/mcss-mcp-server.git
   cd mcss-mcp-server
   

2. 创建并激活虚拟环境：

   python -m venv venv
   # 在 Windows 上
   .\venv\Scripts\activate
   # 在 Linux/Mac 上
   source venv/bin/activate
   

3. 安装所需的依赖项：

   pip install mcp[cli] httpx python-dotenv
   

配置

1. 在项目根目录中创建一个 .env 文件：

   MCSS_HOST=your_mcss_host_ip
   MCSS_PORT=25560
   MCSS_API_KEY=your_mcss_api_key
   

2. 配置 Claude Desktop 使用此 MCP 服务器：

   • 打开您的 Claude Desktop 配置文件：
     • Windows：%AppData%\Claude\claude_desktop_config.json%
     • macOS：%home%/.config/Claude/claude_desktop_config.json%
   • 添加以下配置：

     {
       "mcpServers": {
         "mcss-control": {
           "command": "C:\\path\\to\\mcss-mcp-server\\run_mcss_mcp.bat",
           "args": []
         }
       }
     }
     

   • 将路径替换为您系统上实际的批处理文件路径

🔧 在 Claude Desktop 中使用 MCP 工具

一旦启动 Claude Desktop，服务器将自动开始运行，您可以使用以下工具：

服务器管理

get_servers()

返回所有由 MCSS 管理的 Minecraft 服务器的列表。

get_server_details(server_id)

返回特定服务器的详细信息。

set_server_settings(server_id, settings)

更新指定服务器的设置。

restart_server(server_id)

重启指定服务器。

shutdown_server(server_id)

关闭指定服务器。

份管理

create_backup(server_id)

为指定服务器创建备份。

delete_backup(server_id, backup_id)

删除指定服务器的特定备份。

get_backups(server_id)

返回指定服务器的所有备份列表。

認schedulr 管理

create_schedule(server_id, schedule)

为指定服务器创建新的计划任务。

delete_schedule(server_id, schedule_id)

删除指定服务器的特定计划任务。

get_schedules(server_id)

返回指定服务器的所有计划任务列表。

run_schedule(server_id, schedule_id)

立即运行指定服务器的特定计划任务。

📁 项目结构

mcss-mcp-server/
├── mcss_mcp/                # 主包
│   ├── __init__.py          # 包初始化
│   └── server.py            # MCP 服务器实现
├── main.py                  # 入口脚本
├── run_mcss_mcp.bat         # 批处理脚本以运行服务器
├── .env                     # 环境变量（不在代码库中）
└── README.md                # 此文件

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

📄 许可证

此项目根据 MIT License 许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 感谢

• MCSS 提供了 Minecraft 服务器管理软件
• MCP 提供了模型上下文协议规范
• Claude Desktop 提供了 MCP 客户端实现