Opanel Mcp

OPanel MCP

OPanel MCP Server for AI agents

Description

opanel-mcp is a MCP server for OPanel. After connecting it to an AI agent, you can manage common Minecraft server tasks with simple prompts instead of manually clicking through the panel.

Usage

Prerequisites

• A running OPanel instance
• An enabled OPanel MCP token
• HTTPS access to your OPanel endpoint (required for non-local connections)
• Node.js 18+ and npm

Getting Started

1. Follow the Official Docs to deploy OPanel.

1. Set up HTTPS for your OPanel endpoint.

Configure HTTPS with a reverse proxy (for example Nginx/Caddy) or another TLS solution.

> [!IMPORTANT] > This MCP server only allows: > - https://... for remote hosts > - http://localhost or http://127.0.0.1 for local-only development > > If your server URL is remote and not HTTPS, connection will be rejected.

1. In OPanel, open the MCP page, generate a new access token, and enable MCP.

1. Install the MCP server.

Add the following config to your MCP client, and modify the arguments to match your setup:

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

Arguments:

• --server: Your OPanel URL, such as https://example.com:3000
• --token: Your MCP Access Token generated in the MCP page

Development

You can run with MCP Inspector for local debugging:

npm run build
npm run dev

This command reads SERVER and TOKEN from .env.

Security Notes

• Treat the MCP token as a secret.
• Do not commit tokens into Git.
• Rotate the token in OPanel if you suspect leakage.

License

[MPL-2.0](./LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: opanel-mc
• Source: opanel-mc/opanel-mcp
• License: MPL-2.0
• Homepage: https://opanel.cn/docs/mcp

Install and usage instructions live in the source repository linked above.