Skip to content
Back to search

Unla

๐Ÿงฉ MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/amoylab--unla/badge.svg)](/listings/amoylab--unla)

HTML

<a href="/listings/amoylab--unla"><img src="/api/listings/amoylab--unla/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Unla supports a ready-to-run Docker deployment. Full deployment and configuration instructions are available in the [docs](https://docs.unla.amoylab.com/getting-started/quick-start).

Quick Launch with Docker

Configure environment variables:

export APISERVER_JWT_SECRET_KEY="changeme-please-generate-a-random-secret"
export SUPER_ADMIN_USERNAME="admin"
export SUPER_ADMIN_PASSWORD="changeme-please-use-a-secure-password"

Launch the container:

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 APISERVER_JWT_SECRET_KEY=${APISERVER_JWT_SECRET_KEY} \
  -e SUPER_ADMIN_USERNAME=${SUPER_ADMIN_USERNAME} \
  -e SUPER_ADMIN_PASSWORD=${SUPER_ADMIN_PASSWORD} \
  --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 ยป](https://docs.unla.amoylab.com/getting-started/quick-start)

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 157 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Unla - MCP Gateway
  2. > ๐Ÿš€ Instantly transform your existing MCP Servers and APIs into [MCP](https://modelcontextprotocol.io/) endpoints โ€” without changing a line of code.
  3. [![English](https://img.shields.io/badge/English-Click-yellow)](./README.md)
  4. [![็ฎ€ไฝ“ไธญๆ–‡](https://img.shields.io/badge/็ฎ€ไฝ“ไธญๆ–‡-็‚นๅ‡ปๆŸฅ็œ‹-orange)](docs/README.zh-CN.md)
  5. [![็น้ซ”ไธญๆ–‡](https://img.shields.io/badge/็น้ซ”ไธญๆ–‡-้ปžๆ“ŠๆŸฅ็œ‹-blue)](docs/README.zh-TW.md)
  6. [![Release](https://img.shields.io/github/v/release/mcp-ecosystem/mcp-gateway)](https://github.com/amoylab/unla/releases)
  7. [![Docs](https://img.shields.io/badge/Docs-View%20Online-blue)](https://docs.unla.amoylab.com)
  8. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/mcp-ecosystem/mcp-gateway)
  9. [![Discord](https://img.shields.io/badge/Discord-Join%20our%20Discord-5865F2?logo=discord&logoColor=white)](https://discord.gg/udf69cT9TY)
  10. [![Go Report Card](https://goreportcard.com/badge/github.com/amoylab/unla)](https://goreportcard.com/report/github.com/amoylab/unla)
  11. [![Snyk Security](https://img.shields.io/badge/Snyk-Secure-blueviolet?logo=snyk)](https://snyk.io/test/github/mcp-ecosystem/mcp-gateway)
  12. <a href="https://llmapis.com?source=https%3A%2F%2Fgithub.com%2FAmoyLab%2FUnla" target="_blank"><img src="https://llmapis.com/api/badge/AmoyLab/Unla" alt="LLMAPIS" width="20" /></a>
  13. ---
  14. > โšก **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](https://discord.gg/udf69cT9TY) or [Issues](https://github.com/amoylab/unla/issues) โค๏ธ
  15. ---
  16. ## โœจ What is Unla?
  17. **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](https://modelcontextprotocol.io/) โ€” all through configuration, with **zero code changes**.
  18. https://github.com/user-attachments/assets/69480eda-7aa7-4be7-9bc7-cae57fe16c54
  19. ### ๐Ÿ”ง Core Design Principles
  20. - โœ… Zero Intrusion: Platform-agnostic, supports deployment on bare metal, VMs, ECS, Kubernetes, etc., without modifying existing infrastructure
  21. - ๐Ÿ”„ Configuration-Driven: Convert legacy APIs to MCP Servers using YAML configuration โ€” no code required
  22. - ๐Ÿชถ Lightweight & Efficient: Designed for minimal resource usage without compromising on performance or availability
  23. - ๐Ÿงญ Built-in Management UI: Ready-to-use web interface to simplify setup and reduce operational overhead
  24. ---
  25. ## ๐Ÿš€ Getting Started
  26. Unla supports a ready-to-run Docker deployment. Full deployment and configuration instructions are available in the [docs](https://docs.unla.amoylab.com/getting-started/quick-start).
  27. ### Quick Launch with Docker
  28. Configure environment variables:
  29. ```bash
  30. export APISERVER_JWT_SECRET_KEY="changeme-please-generate-a-random-secret"
  31. export SUPER_ADMIN_USERNAME="admin"
  32. export SUPER_ADMIN_PASSWORD="changeme-please-use-a-secure-password"
  33. ```
  34. Launch the container:
  35. ```bash
  36. docker run -d \
  37. --name unla \
  38. -p 8080:80 \
  39. -p 5234:5234 \
  40. -p 5235:5235 \
  41. -p 5335:5335 \
  42. -p 5236:5236 \
  43. -e ENV=production \
  44. -e TZ=Asia/Shanghai \
  45. -e APISERVER_JWT_SECRET_KEY=${APISERVER_JWT_SECRET_KEY} \
  46. -e SUPER_ADMIN_USERNAME=${SUPER_ADMIN_USERNAME} \
  47. -e SUPER_ADMIN_PASSWORD=${SUPER_ADMIN_PASSWORD} \
  48. --restart unless-stopped \
  49. ghcr.io/amoylab/unla/allinone:latest
  50. ```
  51. ### Access and Configuration
  52. 1. Access the Web Interface:
  53. - Open http://localhost:8080/ in your browser
  54. - Login with the administrator credentials you configured
  55. 2. Add an MCP Server:
  56. - Copy the config from: https://github.com/amoylab/unla/blob/main/configs/proxy-mock-server.yaml
  57. - Click "Add MCP Server" in the web interface
  58. - Paste the configuration and save
  59. ### Available Endpoints
  60. After configuration, the service will be available at these endpoints:
  61. - MCP SSE: http://localhost:5235/mcp/user/sse
  62. - MCP SSE Message: http://localhost:5235/mcp/user/message
  63. - MCP Streamable HTTP: http://localhost:5235/mcp/user/mcp
  64. Configure your MCP Client with the `/sse` or `/mcp` suffix URLs to start using it.
  65. ### Testing
  66. You can test the service using:
  67. 1. The MCP Chat page in the web interface
  68. 2. Your own MCP Client (**recommended**)
  69. ๐Ÿ“– Read the full guide โ†’ [Quick Start ยป](https://docs.unla.amoylab.com/getting-started/quick-start)
  70. ---
  71. ## ๐Ÿš€ Core Features
  72. ### ๐Ÿ”Œ Protocol & Proxy Capabilities
  73. - [x] Support for converting RESTful APIs to MCP Server โ€” Client โ†’ MCP Gateway โ†’ APIs
  74. - [x] Support proxying MCP services โ€” Client โ†’ MCP Gateway โ†’ MCP Servers
  75. - [ ] Support for converting gRPC to MCP Server โ€” Client โ†’ MCP Gateway โ†’ gRPC
  76. - [ ] Support for converting WebSocket to MCP Server โ€” Client โ†’ MCP Gateway โ†’ WebSocket
  77. - [x] Support for MCP SSE
  78. - [x] Support for MCP Streamable HTTP
  79. - [x] Support for MCP responses including text, images, and audio
  80. ### ๐Ÿง  Session & Multi-Tenant Support
  81. - [x] Persistent and recoverable session support
  82. - [x] Multi-tenant support
  83. - [ ] Support for grouping and aggregating MCP servers
  84. ### ๐Ÿ›  Configuration & Management
  85. - [x] Automatic configuration fetching and seamless hot-reloading
  86. - [x] Configuration persistence (Disk/SQLite/PostgreSQL/MySQL)
  87. - [x] Configuration sync via OS Signals, HTTP, or Redis PubSub
  88. - [x] Version control for configuration
  89. ### ๐Ÿ” Security & Authentication
  90. - [x] OAuth-based pre-authentication support for MCP Servers
  91. ### ๐Ÿ–ฅ User Interface
  92. - [x] Intuitive and lightweight management UI
  93. ### ๐Ÿ“ฆ Deployment & Operations
  94. - [x] Multi-replica service support
  95. - [x] Docker support
  96. - [x] Kubernetes and Helm deployment support
  97. ---
  98. ## ๐Ÿ“š Documentation
  99. For more usage patterns, configuration examples, and integration guides, please visit:
  100. ๐Ÿ‘‰ **https://docs.unla.amoylab.com**
  101. ---
  102. ## ๐Ÿ“„ License
  103. This project is licensed under the [MIT License](LICENSE).
  104. ## ๐Ÿ’ฌ Join Our WeChat Community
  105. Scan the QR code below to add us on WeChat. Please include a note: `mcp-gateway`, `mcpgw` or `unla`.
  106. <img src="web/public/wechat-qrcode.png" alt="WeChat QR Code" width="350" height="350" />
  107. ## ๐Ÿ“ˆ Star History
  108. [![Star History Chart](https://api.star-history.com/svg?repos=AmoyLab/Unla&type=Date)](https://star-history.com/#AmoyLab/Unla&Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.