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
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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
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