Celerity Panel
Self-hosted web panel for Hysteria 2 & Xray VLESS proxy servers. Features cascade network topology (Forward/Reverse Chain), SSH auto-setup, server groups, load balancing, ACL traffic filtering, API with scopes, webhooks, S3 backups, MCP integration,
What is Celerity Panel?
Celerity Panel is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to self-hosted web panel for hysteria 2 & xray vless proxy servers. features cascade network topology (forward/reverse chain), ssh auto-setup, server groups, load balancing, acl traffic filtering, api wi...
Self-hosted web panel for Hysteria 2 & Xray VLESS proxy servers. Features cascade network topology (Forward/Reverse Chain), SSH auto-setup, server groups, load balancing, ACL traffic filtering, API with scopes, webhooks, S3 backups, MCP integration,
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Self-hosted web panel for Hysteria 2 & Xray VLESS proxy serv
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx celerity-panelConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Celerity Panel
Celerity Panel (C³ CELERITY) is a self-hosted Node.js web panel for managing Hysteria 2 and Xray VLESS proxy servers, featuring cascade network topology, SSH-based auto node setup, load balancing, ACL traffic filtering, client subscription generation, S3 backups, webhook notifications, and native MCP integration for AI assistant control. It runs as a Docker stack with MongoDB, targets privacy-focused users and infrastructure operators who need a central management interface for censorship-resistant proxy networks, and exposes a RESTful API with scoped access keys alongside the MCP interface for programmatic management.
Prerequisites
- Docker and Docker Compose installed on a Linux server with a public domain name
- A domain name with DNS pointing to your server (required for Let's Encrypt TLS)
- An ACME-compatible email address for Let's Encrypt certificate registration
- MongoDB credentials and a 32-character encryption key (generated with openssl rand -hex 16)
- An MCP-compatible client (Claude Desktop, Cursor) to use the MCP integration feature
Download the Docker Compose file and environment template
Create a working directory and download the required configuration files from the repository.
mkdir celerity-panel && cd celerity-panel
curl -O https://raw.githubusercontent.com/ClickDevTech/hysteria-panel/main/docker-compose.hub.yml
curl -O https://raw.githubusercontent.com/ClickDevTech/hysteria-panel/main/docker.env.example
mkdir -p greenlock.d
curl -o greenlock.d/config.json https://raw.githubusercontent.com/ClickDevTech/hysteria-panel/main/greenlock.d/config.jsonConfigure required environment variables
Copy the example env file, then edit it to set your domain, email, encryption key, session secret, and MongoDB password.
cp docker.env.example .env
# Generate keys:
ENCRYPTION_KEY=$(openssl rand -hex 16) # 32 chars
SESSION_SECRET=$(openssl rand -hex 32)
# Edit .env and set at minimum:
# PANEL_DOMAIN=panel.yourdomain.com
# [email protected]
# ENCRYPTION_KEY=<32-char key from above>
# SESSION_SECRET=<64-char secret from above>
# MONGO_PASSWORD=<strong-password>Start the panel with Docker Compose
Launch all containers. The panel will automatically obtain a TLS certificate from Let's Encrypt for your domain.
docker compose -f docker-compose.hub.yml up -dAccess the panel and create your admin account
Navigate to https://your-domain/panel in a browser. Follow the first-run setup wizard to create an administrator account and configure 2FA if desired.
Enable MCP integration in the panel settings
In the panel's API settings, generate an MCP access key with the appropriate scopes, then add the Celerity endpoint to your MCP client configuration.
{
"mcpServers": {
"celerity": {
"type": "http",
"url": "https://panel.yourdomain.com/mcp",
"headers": {
"Authorization": "Bearer <your-mcp-api-key>"
}
}
}
}Celerity Panel Examples
Client configuration
MCP client configuration for connecting Claude Desktop to a remotely hosted Celerity Panel instance.
{
"mcpServers": {
"celerity-panel": {
"type": "http",
"url": "https://panel.yourdomain.com/mcp",
"headers": {
"Authorization": "Bearer <your-mcp-api-key>"
}
}
}
}Prompts to try
Natural-language commands you can give an AI assistant once it is connected to a running Celerity Panel via MCP.
- "List all active proxy nodes and their current traffic usage"
- "Add a new Hysteria 2 node on server 192.168.1.10 using SSH auto-setup"
- "Show the current load balancing configuration across all server groups"
- "Generate a Clash subscription link for user [email protected]"
- "Trigger an S3 backup of the current panel configuration"Troubleshooting Celerity Panel
Let's Encrypt certificate fails to issue on startup
Ensure your domain's DNS A record points to the server's public IP and that ports 80 and 443 are open in your firewall. The ACME_EMAIL and PANEL_DOMAIN variables in .env must be set correctly before starting the containers.
Panel is inaccessible after docker compose up
Check container logs with: docker compose -f docker-compose.hub.yml logs --tail=50. Common causes are an incorrect MONGO_PASSWORD or a port conflict. Verify that ports 80, 443, and the Hysteria 2 UDP port are not in use by other services.
MCP API calls return 401 Unauthorized
Regenerate your API key in the panel's API settings and ensure you are passing it as: Authorization: Bearer <key> in the MCP client's headers configuration. Scoped keys may lack the permissions needed for certain operations.
Frequently Asked Questions about Celerity Panel
What is Celerity Panel?
Celerity Panel is a Model Context Protocol (MCP) server that self-hosted web panel for hysteria 2 & xray vless proxy servers. features cascade network topology (forward/reverse chain), ssh auto-setup, server groups, load balancing, acl traffic filtering, api with scopes, webhooks, s3 backups, mcp integration, It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Celerity Panel?
Follow the installation instructions on the Celerity Panel GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Celerity Panel?
Celerity Panel works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Celerity Panel free to use?
Yes, Celerity Panel is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Celerity Panel Alternatives — Similar Cloud Services Servers
Looking for alternatives to Celerity Panel? 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 Celerity Panel 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 Celerity Panel?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.