AmoyLab/Unla

> 🚀 Instantly transform your existing MCP Servers and APIs into MCP endpoints — without changing a line of code.
> ⚡ Note: Unla is under rapid development! We strive to maintain backward compatibility, but it cannot be 100% guaranteed. Please make sure to check version changes carefully when upgrading. Due to the fast iteration, documentation updates may sometimes lag behind. If you encounter any issues, feel free to search or ask for help via Discord or Issues ❤️
## ✨ What is Unla?
Unla is a lightweight and highly available gateway service written in Go. It enables individuals and organizations to convert their existing MCP Servers and APIs into services compliant with the MCP Protocol — all through configuration, with zero code changes.
https://github.com/user-attachments/assets/69480eda-7aa7-4be7-9bc7-cae57fe16c54
### 🔧 Core Design Principles
✅ Zero Intrusion: Platform-agnostic, supports deployment on bare metal, VMs, ECS, Kubernetes, etc., without modifying existing infrastructure
🔄 Configuration-Driven: Convert legacy APIs to MCP Servers using YAML configuration — no code required
🪶 Lightweight & Efficient: Designed for minimal resource usage without compromising on performance or availability
🧭 Built-in Management UI: Ready-to-use web interface to simplify setup and reduce operational overhead
## 🚀 Getting Started
Unla supports a ready-to-run Docker deployment. Full deployment and configuration instructions are available in the docs.
### Quick Launch with Docker
Configure environment variables:
bash
export APISERVERJWTSECRETKEY="changeme-please-generate-a-random-secret"
export SUPERADMINUSERNAME="admin"
export SUPERADMINPASSWORD="changeme-please-use-a-secure-password"
Launch the container:
bash
docker run -d \
--name unla \
-p 8080:80 \
-p 5234:5234 \
-p 5235:5235 \
-p 5335:5335 \
-p 5236:5236 \
-e ENV=production \
-e TZ=Asia/Shanghai \
-e APISERVERJWTSECRETKEY=${APISERVERJWTSECRETKEY} \
-e SUPERADMINUSERNAME=${SUPERADMINUSERNAME} \
-e SUPERADMINPASSWORD=${SUPERADMINPASSWORD} \
--restart unless-stopped \
ghcr.io/amoylab/unla/allinone:latest
### Access and Configuration
1. Access the Web Interface:
Open http://localhost:8080/ in your browser
Login with the administrator credentials you configured
2. Add an MCP Server:
Copy the config from: https://github.com/amoylab/unla/blob/main/configs/proxy-mock-server.yaml
Click "Add MCP Server" in the web interface
Paste the configuration and save
### Available Endpoints
After configuration, the service will be available at these endpoints:
MCP SSE: http://localhost:5235/mcp/user/sse
MCP SSE Message: http://localhost:5235/mcp/user/message
MCP Streamable HTTP: http://localhost:5235/mcp/user/mcp
Configure your MCP Client with the /sse or /mcp suffix URLs to start using it.
### Testing
You can test the service using:
1. The MCP Chat page in the web interface
2. Your own MCP Client (recommended)
📖 Read the full guide → Quick Start »
## 🚀 Core Features