1Panel MCP Server Launched: Ushering in a New Era of AI-Powered Conversational Server Operations

1Panel MCP Server Launched: Ushering in a New Era of AI-Powered Conversational Server Operations

The 1Panel open-source project team is thrilled to announce the release of 1Panel MCP Server, an innovative open-source tool designed to revolutionize Linux server management through AI-driven conversational interactions. Built on the Model Context Protocol (MCP), this solution simplifies server operations and delivers a cutting-edge management experience tailored for the AI era.

The Evolution of Server Management

Server management has progressed from command-line interfaces to graphical web-based dashboards. With the advent of AI, natural language interaction becomes the next frontier. The MCP protocol serves as a bridge, enabling AI models to seamlessly integrate with external tools, access data, and facilitate service interactions—opening doors to profound human-machine collaboration.

Core Features of 1Panel MCP Server

  • Protocol-Driven Architecture: As an intermediary layer, MCP Server connects user commands to backend services (e.g., website creation, database deployment), enabling cross-tool collaboration.
  • Deep Integration with 1Panel: Directly leverages 1Panel's APIs for high-frequency tasks like reverse proxy setup, static website deployment, SSL certificate management, and database configuration, significantly lowering operational barriers.
  • Open Source & Extensible: Fully open-source codebase allows developers to customize tools and build personalized workflows.

Getting Started: Integrating with MCP Clients

1Panel MCP Server works with MCP-compatible clients (e.g., Cursor, Claude, Windsurf, Cline) to execute server operations via natural language.
Example: Adding 1Panel MCP Server to Cursor

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "your_token",
        "PANEL_HOST": "http://localhost:8080"
      }
    }
  }
}

Practical Use Cases

  1. Server Overview Retrieval
    Example command: Get server status report
  2. OpenResty Installation & Website Creation
    Example command: Install OpenResty and create a website with domain example.com
  3. MySQL Installation & Database Setup
    Example command: Install MySQL 8.0 and create a database named "app_db"

Installation Guide

Method 1: Source Code Build

git clone https://github.com/1Panel-dev/mcp-1panel.git
cd mcp-1panel
make build
mv ./build/mcp-1panel /usr/local/bin/

Method 2: Go Install (One-Click)

go install github.com/1Panel-dev/mcp-1panel@latest

Configuration & Execution

  1. Obtain 1Panel Access Token
    Navigate to 1Panel Dashboard → "Settings" → "API Management" to generate an access token.
  2. Choose Communication Mode
    • STDIO Mode (Default): Local integration via standard input/output.
{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "your_token",
        "PANEL_HOST": "http://localhost:8080"
      }
    }
  }
}
    • SSE Mode: Remote communication for distributed environments.
# Start server
mcp-1panel -host http://1panel-host:port -token your_token -transport sse -addr "http://localhost:8000"

# Client configuration
{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Key Command-Line Options

Option Description
-token 1Panel access token
-host 1Panel service address (e.g.,http://localhost:8080)
-transport Communication protocol (stdioor sse)
-sse-port SSE service port (default: 8000)

Conclusion

1Panel MCP Server represents more than just a tool upgrade—it marks a paradigm shift in server operations. By transitioning from manual configurations to conversational interactions, it empowers users with smarter, more intuitive management. Whether for individual developers or enterprise teams, 1Panel MCP Server unlocks the full potential of AI-driven server management.

Back to blog