1Panel MCP Server
The 1Panel MCP Server enables AI agents to manage a 1Panel instance through 264 tools covering its complete API, including 100% of open-source features and ~90% of professional (XPack) features.
Container Management: List, start, stop, and restart Docker containers by ID
Image Management: List existing Docker images and pull new ones by name
Docker Compose: List all configured Compose projects
Application Management: View installed applications and browse the app store
File Management: List files at a specified path
Website Management: List configured websites and SSL certificates
Database Management: List databases for MySQL, PostgreSQL, and Redis
System Monitoring: Retrieve system information and real-time monitor data (CPU, memory, etc.)
Enables comprehensive management of 1Panel instances, including system monitoring, website management, SSL certificate tracking, and application lifecycle control.
Provides tools to list, start, stop, and restart containers, pull images, and manage Docker Compose projects through the 1Panel interface.
Allows for the management and listing of MySQL databases hosted on the 1Panel server.
Allows for the management and listing of PostgreSQL databases hosted on the 1Panel server.
Allows for the management and listing of Redis databases hosted on the 1Panel server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@1Panel MCP Server show me the current CPU usage and list all running containers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
1Panel MCP Server
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
Global Installation (Recommended)
npm install -g 1panel-mcp-serverLocal Installation
npm install 1panel-mcp-serverUsage
Quick Start
Get your 1Panel API key:
Login to 1Panel web interface
Go to Profile → API
Generate or copy your API key
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-keyCommands
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-keyEnvironment Variables
Variable | Description | Default |
| 1Panel host |
|
| 1Panel port |
|
| 1Panel API key (required) | - |
|
|
|
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-keyAPI Coverage
Category | Tools | Coverage |
Open Source | 205 | 100% |
XPack (Pro) | 59 | ~90% |
Total | 264 | ~98% |
License
MIT
Links
Available Tools
15 toolsget_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
Scored across 15 tools
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.
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.
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.
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
Related MCP Connectors
Manage NodePal Minecraft servers, worlds, mods, backups and console from AI agents.
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Backend platform for AI agents: one agentstack.execute tool runs batched steps over +700 actions (hosting, storage, auth, payments, CRM, app builder).
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables 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.295MIT
- AlicenseBqualityDmaintenanceEnables 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.2360 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides 50 tools to manage a CloudPanel VPS through AI assistants, covering sites, databases, Docker, server software, firewall, DNS, and one-shot deployments.21 npm4MIT
- AlicenseNot gradedqualityDmaintenanceFull-featured MCP server for 1Panel server management panel. Provides 490+ tools for managing websites, databases, containers, files, and more through natural language.MIT