Skip to main content
Glama
1Panel MCP Server
by EaveLuo

1Panel MCP Server

npm version License: MIT

MCP (Model Context Protocol) server for 1Panel - Manage your 1Panel through AI agents like Claude, Cursor, or any MCP-compatible client.

Features

  • 264 Tools covering 1Panel's complete API

  • 100% Open Source version coverage

  • ~90% Professional (XPack) version coverage

  • Modular architecture with TypeScript

Supported Modules

Core: Containers, Images, Networks, Volumes, Docker Compose Applications: App Store, Runtime Environments, PHP, Node.js Files: File Management, Backup, Recycle Bin, Snapshots Database: MySQL, PostgreSQL, Redis Website: Websites, SSL, Nginx, AntiLeech System: Monitor, Processes, Cronjobs, Firewall, Fail2ban Security: SSH, Terminal, ClamAV Antivirus AI & Advanced: AI Agent, MCP Server, Ollama, GPU, OpenResty Host Management: Remote Hosts, SSH Keys

Related MCP server: server-ops-mcp

Installation

npm install -g 1panel-mcp-server

Local Installation

npm install 1panel-mcp-server

Usage

Quick Start

  1. Get your 1Panel API key:

    • Login to 1Panel web interface

    • Go to Profile → API

    • Generate or copy your API key

  2. Start the MCP server:

# Using environment variables
export ONEPANEL_API_KEY=your-api-key
export ONEPANEL_HOST=localhost
export ONEPANEL_PORT=8080
1panel-mcp-server start

# Using command line options
1panel-mcp-server start --host 192.168.1.100 --port 8080 --key your-api-key

# Using HTTPS
1panel-mcp-server start --host panel.example.com --secure --key your-api-key

# Using short command
1pmcp start --key your-api-key

Commands

1panel-mcp-server --help              # Show help
1panel-mcp-server start --help        # Show start options
1panel-mcp-server config              # Show configuration guide
1panel-mcp-server tools               # List available tools

# Or use short command
1pmcp --help
1pmcp start --key your-api-key

Environment Variables

Variable

Description

Default

ONEPANEL_HOST

1Panel host

localhost

ONEPANEL_PORT

1Panel port

8080

ONEPANEL_API_KEY

1Panel API key (required)

-

ONEPANEL_PROTOCOL

http or https

http

MCP Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "1panel": {
      "command": "1panel-mcp-server",
      "args": ["start"],
      "env": {
        "ONEPANEL_HOST": "localhost",
        "ONEPANEL_PORT": "8080",
        "ONEPANEL_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to Cursor MCP settings:

{
  "mcpServers": {
    "1panel": {
      "command": "1panel-mcp-server",
      "args": ["start", "--host", "localhost", "--port", "8080", "--key", "your-api-key"]
    }
  }
}

Development

# Clone the repository
git clone https://github.com/EaveLuo/1panel-mcp.git
cd 1panel-mcp

# Install dependencies
npm install

# Build
npm run build

# Development mode
npm run dev

# Start locally
npm start

# Or use the CLI
npm link
1panel-mcp-server start --key your-api-key

API Coverage

Category

Tools

Coverage

Open Source

205

100%

XPack (Pro)

59

~90%

Total

264

~98%

License

MIT

Available Tools

15 tools
get_system_infoC

Get system info

Inputs: no named parameters.

get_system_monitorC

Get system monitor data

Inputs: no named parameters.

list_app_storeD

List app store

Inputs: no named parameters.

list_certificatesB

List SSL certificates

Inputs: no named parameters.

list_composesB

List compose projects

Inputs: no named parameters.

list_containersB

List all Docker containers

Inputs: no named parameters.

list_databasesD

List databases

Inputs: type (required).

list_filesD

List files

Inputs: path (required).

list_imagesB

List Docker images

Inputs: no named parameters.

list_installed_appsC

List installed apps

Inputs: no named parameters.

list_websitesD

List websites

Inputs: no named parameters.

pull_imageC

Pull a Docker image

Inputs: name (required).

restart_containerC

Restart a container

Inputs: id (required).

start_containerC

Start a container

Inputs: id (required).

stop_containerC

Stop a container

Inputs: id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 15 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific resources like system info, containers, images, files, or certificates. There is no overlap in functionality—each tool name precisely indicates what it operates on, eliminating any ambiguity for agent selection.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern, primarily using 'list_' for retrieval operations and specific verbs like 'get_', 'pull_', 'restart_', 'start_', and 'stop_' for other actions. This uniformity makes the tool set predictable and easy to navigate.

    Tool Count5/5

    With 15 tools, the server is well-scoped for managing a 1Panel system, covering key areas like system monitoring, Docker container management, app handling, and file/certificate operations. Each tool earns its place without feeling excessive or insufficient for the domain.

    Completeness4/5

    The tool set provides comprehensive coverage for monitoring and managing a 1Panel system, including CRUD-like operations for containers (start, stop, restart) and listing various resources. Minor gaps exist, such as no tools for creating or deleting containers, images, or certificates, but agents can still perform core workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to manage infrastructure and deploy Docker services through EasyPanel using natural language commands. It supports full lifecycle management of services, deployments, and networks while facilitating automated scaling and assisted debugging.
      29
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI tools to perform server operations such as log inspection, system monitoring, code management, Nginx and certificate management, with support for local and remote SSH modes and built-in security controls.
      23
      60 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 50 tools to manage a CloudPanel VPS through AI assistants, covering sites, databases, Docker, server software, firewall, DNS, and one-shot deployments.
      21 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Full-featured MCP server for 1Panel server management panel. Provides 490+ tools for managing websites, databases, containers, files, and more through natural language.
      MIT