OPanel MCP

OPanel MCP

用于AI代理的OPanel MCP服务器

描述

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

用法

先决条件

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

入门指南

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

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

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

\[！重要\] 此MCP服务器仅允许： - https://... 对于远程主机 - http://localhost 或 http://127.0.0.1 仅用于本地开发 如果您的服务器URL是远程的，而不是HTTPS，则连接将被拒绝。

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

1. 安装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