⛏️ McPorter 视界联结

游戏操控 · RCON 底层 · 状态雷达

专为 Minecraft 服务器打造的智能体联结端口。通过它大模型可全天候监视服务器的在线动态，甚至直接通过 RCON 穿透后台，执行惩罚机制和世界级广播指令。

OpenClaw Team

🚀 快速安装

在您的终端中执行以下命令即可完成安装：

npx clawhub install mcporter

📊 数据总览

⭐ 收藏点赞	☁️ 总计调用	👥 当前活跃	🎯 稳定版本
458	12.9k	680	v1.1.5

🎛️ 详解：它是如何运转的？

McPorter 是一个架设在现实与虚拟方块世界中间的安全闸门，它由两大部分核心机能组成：

🟢 零负载的 Ping 查询协议：当您需要了解服务器的存活情况或是玩家在线列表，它不会打扰到服务端的运算池。McPorter 采用原生的 Server List Ping 协议，在一两秒内向 AI 返回 MOTD、版本号、最大承载量和当前在线活人 UUID 列表等只读参数。
🔌 RCON 高权指令执行通道：它支持与 Bukkit / Spigot / Paper / Fabric 等各大主流架构的 RCON 端口桥接。AI 可以构造合法的命令串直接发送过去（诸如 /weather clear，/give 或 /ban），并且可以将命令返回的控制台字符串反向输入大模型的消化道。
🛡️ 无头守护进程挂载：不需要长期占用操作系统的图形界面或者专门的挂机假人，脚本纯 Node 层运行。
🎮 多版本协议头向下兼容：即使您的服主还停留在 1.8 甚至 1.12.2 这样的上古黄金版本，本插件的跨代协议层也保证能够完美下探建立握手连接。

🧭 典型业务场景剖析

👮 场景一：智能体风控巡查与脏话管控

利用此模块与聊天挂钩，大模型可以化身一名无所不知的服务器监督员。当 Agent 分析出某个玩家在游戏聊天频道或者关联社区发布恶意炸服言论或是言语违规行为时，模型会被触发执行判断逻辑：立即挂载 mcporter 的 RCON 通道，发送 /kick <player> 涉及不良言论警告 或触发更高级的封禁，且全程零人工干预。

📊 场景二：生态报告跨渠道智能推送

对于公会或者社群主理人：可以用 Cron 定时任务编排。每天晚上黄金档让模型调用 mcporter 收集一次在线所有玩家列表与服务器的 TPS 状态值，然后用温和幽默的语调将其整理成一篇短报发送到微信或者 Slack 群组："今晚共有 30 名大佬在线奋战，TPS 满载运行，快上线一起盖房拉！"

💻 常用命令参考

安装完成后，您不仅可以通过对话让 AI 自主调用，还可以在 CLI 侧手动发起操作：

探针模式——打出无害化的 Ping 数据包提取当前实时世界元数据：

clawhub execute mcporter action="status" \
  server="play.hypixel.net" port=25565

神罚模式——登录高特权 RCON 桥发送变更现实的原始执行串：

clawhub execute mcporter action="rcon" \
  server="192.168.1.100" rcon_port=25575 \
  command="/broadcast &a[ServerAI] Weekend exp boost activated!"

🛡️ 环境要求与配置门槛防护

🔓 只读免密：若仅使用 action="status" 进行查询，目标服务端无需任何操作即可开放测试。
⚙️ 开启 RCON 配置：为了让 AI 拿到控制权（action="rcon"），您必须前往 MC 服务端下的 server.properties 文件，手动设定 enable-rcon=true，设置高强度的 rcon.password，并务必在运行 Agent 时配置好等效的环境变量防止密码泄漏。

🔗 查看 GitHub 源代码