UWAS
Unified Web Application Server — Apache+Nginx+Varnish+Caddy in a single Go binary. Auto HTTPS, built-in caching, PHP/FastCGI, reverse proxy, load balancing, WAF, web dashboard, and MCP server.
What is UWAS?
UWAS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unified web application server — apache+nginx+varnish+caddy in a single go binary. auto https, built-in caching, php/fastcgi, reverse proxy, load balancing, waf, web dashboard, and mcp server.
Unified Web Application Server — Apache+Nginx+Varnish+Caddy in a single Go binary. Auto HTTPS, built-in caching, PHP/FastCGI, reverse proxy, load balancing, WAF, web dashboard, and MCP server.
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Unified Web Application Server — Apache+Nginx+Varnish+Caddy
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx uwasConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use UWAS
UWAS (Unified Web Application Server) is a single Go binary that combines the core capabilities of Apache, Nginx, Varnish, and Caddy, including automatic HTTPS via Let's Encrypt, built-in Varnish-style caching, PHP/FastCGI support, reverse proxy, load balancing, a Web Application Firewall, and a React-based web dashboard. It includes a built-in MCP server exposing server status, domain management, log access, cache control, and configuration reloading tools — making it AI-agent friendly for LLM-driven infrastructure automation and management workflows.
Prerequisites
- A Linux, macOS, or Windows machine with outbound port 80/443 access for Let's Encrypt ACME challenges
- A domain name with DNS records pointing to the server for automatic HTTPS
- Root or sudo access for system-level installation and port binding below 1024
- An MCP-compatible client such as Claude Desktop or Claude Code to use the MCP tools
Install UWAS with the install script
Run the one-line install script to download and install the UWAS binary. The script places the binary on your PATH.
curl -fsSL https://raw.githubusercontent.com/uwaserver/uwas/main/install.sh | shOr build from source
If you prefer to build from source, clone the repository and use the provided Makefile.
git clone https://github.com/uwaserver/uwas.git
cd uwas
make buildInstall as a system service
Register UWAS as a systemd service so it starts on boot and is managed by the system supervisor.
sudo uwas install
sudo systemctl start uwasCreate the uwas.yaml configuration file
Create your site configuration. The minimal config below enables automatic HTTPS for a static site. Add your Let's Encrypt email address and domain.
http_listen: ":80"
https_listen: ":443"
acme:
email: [email protected]
vhosts:
- host: example.com
root: /var/www/example
type: static
ssl:
mode: autoConfigure MCP client to connect to the UWAS MCP server
UWAS exposes an MCP interface for AI-driven management. Add it to your MCP client configuration. The MCP endpoint is available locally by default.
{
"mcpServers": {
"uwas": {
"url": "http://localhost:9443/mcp"
}
}
}Validate configuration and check server status
Use the CLI to validate your config before applying it, then check that the server is running correctly.
uwas config validate
uwas statusUWAS Examples
Client configuration
MCP client config connecting to the UWAS MCP server running locally for AI-driven server management.
{
"mcpServers": {
"uwas": {
"url": "http://localhost:9443/mcp"
}
}
}Prompts to try
Example prompts for managing UWAS through the MCP server.
- "Show me the current UWAS server status and uptime."
- "List all configured domains and their SSL status."
- "Purge the cache for example.com and show the current cache hit rate."
- "Show the last 50 error log entries for the example.com vhost."
- "Reload the UWAS configuration without restarting the server."Troubleshooting UWAS
Let's Encrypt certificate provisioning fails with ACME challenge errors
Ensure port 80 is open and reachable from the internet — Let's Encrypt uses an HTTP-01 challenge on port 80 even when your site runs on HTTPS. Check firewall rules and cloud security group settings. Your DNS A/AAAA record must also resolve to the server's public IP.
uwas install fails with permission denied on port 80/443
Ports below 1024 require root privileges on Linux. Run `sudo uwas install` and `sudo systemctl start uwas`. Alternatively, configure UWAS to listen on unprivileged ports and use a firewall DNAT rule to redirect traffic.
MCP client cannot connect to the UWAS MCP server
Verify UWAS is running with `uwas status` and that the dashboard is accessible at http://your-ip:9443/_uwas/dashboard/. If the MCP endpoint is not reachable, check that no firewall rule is blocking port 9443 from the MCP client's machine.
Frequently Asked Questions about UWAS
What is UWAS?
UWAS is a Model Context Protocol (MCP) server that unified web application server — apache+nginx+varnish+caddy in a single go binary. auto https, built-in caching, php/fastcgi, reverse proxy, load balancing, waf, web dashboard, and mcp server. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install UWAS?
Follow the installation instructions on the UWAS GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with UWAS?
UWAS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is UWAS free to use?
Yes, UWAS is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
UWAS Alternatives — Similar Cloud Services Servers
Looking for alternatives to UWAS? 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 UWAS 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 UWAS?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.