1Panel
1Panel MCP Server is an implementation of the Model Context Protocol (MCP) server for 1Panel.
What is 1Panel?
1Panel is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 1panel mcp server is an implementation of the model context protocol (mcp) server for 1panel.
1Panel MCP Server is an implementation of the Model Context Protocol (MCP) server for 1Panel.
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 1Panel MCP Server is an implementation of the Model Context
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-1panelConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use 1Panel
The 1Panel MCP Server connects AI assistants to 1Panel, the open-source Linux server management panel. Through this server, Claude and other MCP clients can query system dashboards, manage websites, handle SSL certificates, install and control applications, and create databases — all without leaving the chat interface. It is built in Go and communicates via stdio or SSE transport, making it suitable for both local and remote 1Panel instances.
Prerequisites
- A running 1Panel instance (v1.x or later) with a known host address (e.g., http://localhost:8080)
- A 1Panel API access token (generated in 1Panel's user settings under API credentials)
- Go 1.23+ if installing from source, or a pre-built binary for your platform
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Install the mcp-1panel binary
Download the pre-built binary for your platform from the GitHub releases page, make it executable, and move it to a directory on your PATH. Alternatively, install from source with Go.
go install github.com/1Panel-dev/mcp-1panel@latestObtain your 1Panel access token
Log in to your 1Panel dashboard, navigate to User Settings → API, and generate a new access token. Copy the token value; you will need it for the MCP configuration.
Configure environment variables
Set PANEL_HOST to your 1Panel instance URL and PANEL_ACCESS_TOKEN to the token you generated. These are the only required credentials.
export PANEL_HOST="http://localhost:8080"
export PANEL_ACCESS_TOKEN="your_access_token_here"Add the server to your MCP client config
Edit claude_desktop_config.json (or your client's equivalent) to register mcp-1panel as a stdio MCP server with the required environment variables.
{
"mcpServers": {
"1panel": {
"command": "mcp-1panel",
"args": ["-transport", "stdio"],
"env": {
"PANEL_HOST": "http://localhost:8080",
"PANEL_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen MCP client so it picks up the new server definition. The 1Panel tools should now appear in the available tools list.
1Panel Examples
Client configuration
Add this block to claude_desktop_config.json. Replace the PANEL_HOST and PANEL_ACCESS_TOKEN values with your own.
{
"mcpServers": {
"1panel": {
"command": "mcp-1panel",
"args": ["-transport", "stdio"],
"env": {
"PANEL_HOST": "http://localhost:8080",
"PANEL_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Prompts to try
Example natural-language prompts you can send once the server is connected.
- "Show me the current system dashboard and resource usage"
- "List all websites configured in 1Panel"
- "Create a new website for domain example.com with OpenResty"
- "List all SSL certificates and show which ones expire within 30 days"
- "Install MySQL and create a new database called myapp_db"
- "Show me all installed applications and their status"Troubleshooting 1Panel
Authentication error: 401 Unauthorized
Verify that PANEL_ACCESS_TOKEN is correct and has not expired. Regenerate the token in 1Panel's API settings and update the env block in your config.
Cannot connect to 1Panel: connection refused
Confirm that PANEL_HOST points to the correct host and port, and that the 1Panel service is running. If 1Panel is behind a firewall or VPN, ensure the MCP server host has network access to it.
mcp-1panel binary not found after go install
Ensure $(go env GOPATH)/bin is in your PATH. Run `export PATH=$PATH:$(go env GOPATH)/bin` and try again.
Frequently Asked Questions about 1Panel
What is 1Panel?
1Panel is a Model Context Protocol (MCP) server that 1panel mcp server is an implementation of the model context protocol (mcp) server for 1panel. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install 1Panel?
Follow the installation instructions on the 1Panel GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with 1Panel?
1Panel works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is 1Panel free to use?
Yes, 1Panel is open source and available under the GPL 3.0 license. You can use it freely in both personal and commercial projects.
1Panel Alternatives — Similar Cloud Services Servers
Looking for alternatives to 1Panel? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up 1Panel in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use 1Panel?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.