drio
Open app

1Panel MCP Server

Source

mcp-1panel is the Model Context Protocol (MCP) server implementation for 1Panel.

Catalog onlyCatalog onlySTDIO

Overview

Mcp 1panel is an implementation of the Model Context Protocol (MCP) server designed for 1Panel, enabling seamless interaction with various tools and services.

To use Mcp 1panel, you can either build it from source or install it using Go. After installation, configure it with your 1Panel access token and host address, and start the server using the command line options provided.

  • Supports multiple transport types (stdio and sse) - Provides various tools for managing websites, databases, and applications - Easy configuration through environment variables
  1. Managing website deployments and configurations.
  2. Interacting with databases for creating and listing entries.
  3. Automating the installation of applications like MySQL and OpenResty.

Add to your AI client

Use these steps to connect 1Panel MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-1panel-1panel-dev": {
      "command": "mcp-1panel",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-1panel-1panel-dev"
      ],
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-1panel-1panel-dev": {
      "command": "mcp-1panel",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-1panel-1panel-dev"
      ],
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-1panel-1panel-dev": {
      "command": "mcp-1panel",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-1panel-1panel-dev"
      ],
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-1panel-1panel-dev": {
      "type": "stdio",
      "command": "mcp-1panel",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-1panel-1panel-dev"
      ],
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-1panel-1panel-dev": {
      "command": "mcp-1panel",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-1panel-1panel-dev"
      ],
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-1panel-1panel-dev": {
      "command": "mcp-1panel",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-1panel-1panel-dev"
      ],
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

FAQ

What is the Model Context Protocol (MCP)?

MCP is a protocol that allows for standardized communication between different services and tools.

How do I configure the server?

You can configure the server using command line options or environment variables for the access token and host address.

Is Mcp 1panel compatible with all versions of 1Panel?

It is designed to work with existing 1Panel installations, but ensure you meet the prerequisites.

Developer tools