1Panel MCP Server
Manage 1Panel Server Panel via the MCP Protocol
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: 1Panel MCP Server. It is used for: Manage 1Panel Server Panel via the MCP Protocol Full Skill content: https://321skill.com/skills/1panel-mcp-server/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the issue where operations personnel or developers cannot directly manage 1Panel servers through an AI assistant. In practical work, frequently logging into the panel and manually performing operations such as website creation, SSL certificate configuration, and database management is time-consuming and error-prone. By integrating the MCP protocol, the 1Panel MCP Server enables AI to directly read panel status and execute management operations, transforming repetitive Ops tasks into natural language commands, thereby significantly improving efficiency.
Usage is straightforward. You simply need to install the 1Panel MCP Server (supported via binary download, Go compilation, Docker, and other methods), then configure two environment variables: PANEL_HOST (panel address) and PANEL_ACCESS_TOKEN (access token). Afterward, in MCP clients like Cursor or Windsurf, you can directly instruct the AI with commands like "view the dashboard," "create a website," or "list all databases," and it will automatically invoke the corresponding tools to complete the operations. The service supports both stdio and SSE transport modes, allowing flexible integration into local or remote development environments.
It is particularly suitable for Ops engineers, backend developers, and full-stack developers who need to manage 1Panel servers. This is especially true for teams or individuals already using 1Panel as their server management panel and wishing to integrate their AI coding assistants (like Cursor, Claude Desktop) as a unified Ops interface. For scenarios requiring frequent website deployment, SSL certificate renewal, application installation, or database creation, this Skill can significantly reduce manual operation time.
It is recommended to configure this MCP server in each developer's AI assistant when a team uniformly uses 1Panel for server management to standardize Ops operations. Note that it primarily relies on the API capabilities of the 1Panel panel itself, so the panel must be in normal operation, and the access token must have sufficient permissions. Additionally, when starting in SSE mode, ensure the network port is not blocked by a firewall to guarantee smooth communication between the AI assistant and the MCP server.
Key Features
Compared to the official 1Panel CLI or REST API, the 1Panel MCP Server directly integrates with AI coding assistants via the MCP protocol. Developers don't need to remember curl commands or log into the panel; they can complete operations using natural language directly. It supports both stdio and SSE modes, adapting to local and remote development scenarios.
Limitations
Requires the 1Panel panel to be running normally and configured with a valid access token; compiling from source requires Go 1.23+; running via Docker requires Docker to be pre-installed and the image pulled.
FAQ
How do I obtain the 1Panel access token?
Log into the 1Panel panel, navigate to 'Settings' → 'Security' → 'API Keys', then create or copy an existing Access Token. If none exists, create one first. The token must have the corresponding administrative permissions.
Which AI tools are supported?
Supports all clients that adhere to the MCP protocol, such as Cursor, Windsurf, Claude Desktop, etc. Configure it as a local command in stdio mode or as a URL connection in SSE mode.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/1panel-mcp-server/raw/index.md to read the original Skill definition (Markdown format) for 1Panel MCP Server, and install it according to the instructions.
Raw Markdown URL for AI: /skills/1panel-mcp-server/raw/index.md