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 "Install 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 Servershow 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: EasyPanel MCP Server
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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceEnables AI agents to manage Minecraft servers through MCSManager, including instance control (start/stop/restart), file management, scheduled tasks, user management, and backup operations.Last updated5
- Alicense-qualityCmaintenanceEnables 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.Last updated4MIT
- Alicense-qualityDmaintenanceEnables AI agents to manage Plesk hosting environments through a set of standardized tools for security, health monitoring, DNS, email, backups, and service management.Last updatedMIT
- AlicenseBqualityBmaintenanceEnables 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.Last updated2386MIT
Related MCP Connectors
Agent-native web hosting — deploy sites, manage DNS, register domains, scale infrastructure
Operate your Linux servers from your LLM. Every action runs through an auditable allowlist.
Create and manage AI agents that collaborate and solve problems through natural language interacti…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/EaveLuo/1panel-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server