AI导哈

AI代理MCP服务器

OPanel MCP是一个用于管理Minecraft服务器的AI代理服务，通过简单提示替代手动操作。

  • by opanel-mc
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 opanel-mc/opanel-mcp

使用说明

OPanel MCP

用于AI代理的OPanel MCP服务器

描述

opanel-mcp 是OPanel的MCP服务器。将其连接到AI代理后，您可以使用简单的提示来管理常见的Minecraft服务器任务，而无需手动单击面板。

用法

先决条件

  • 正在运行的OPanel实例
  • 已启用的OPanel MCP令牌
  • HTTPS访问您的OPanel端点（非本地连接需要）
  • Node.js 18+和npm

入门指南

  1. 跟随 官方文件 部署OPanel。

  2. 为您的OPanel端点设置HTTPS。

使用反向代理（例如Nginx/Caddy）或其他TLS解决方案配置HTTPS。

[！重要] 此MCP服务器仅允许：

  • https://... 对于远程主机
  • http://localhost 或 http://127.0.0.1 仅用于本地开发

如果您的服务器URL是远程的，而不是HTTPS，则连接将被拒绝。

  1. 在OPanel中，打开MCP页面，生成新的访问令牌，并启用MCP。

  2. 安装MCP服务器。

将以下配置添加到MCP客户端，并修改参数以匹配您的设置：

{
  "mcpServer": {
    "opanel": {
      "command": "npx",
      "args": [
        "opanel-mcp@latest",
        "--server", "...",
        "--token", "..."
      ]
    }
  }
}

论据：

  • --server：您的OPanel URL，例如 https://example.com:3000
  • --token：您在MCP页面中生成的MCP访问令牌

发展

您可以使用MCP Inspector进行本地调试：

npm run build
npm run dev

此命令读取 SERVER 和 TOKEN 从 .env.

安全说明

  • 将MCP令牌视为秘密。
  • 不要将令牌提交到Git中。
  • 如果怀疑泄漏，请旋转OPanel中的令牌。

许可证

MPL-2.0

相关 MCP