local_fire_departmentHoneystax
search⌘K
loginLog Inperson_addSign Up
layers
HONEYSTAX TERMINAL v1.0
HomeNewsSavedSubmit
Back to the live board
U

Unla

MCP Server

MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP serve...

Copy the install, test the workflow, then decide if it earns a permanent slot.

2,070
Why nowMoving now

Fresh repo activity plus visible builder pull. This is the kind of tool people test before it turns obvious.

DecisionHigh-conviction move

Copy the install, test the workflow, then decide if it earns a permanent slot.

Trial costMedium lift

Testable in one sitting, but you will likely touch real infra or local setup before you know if it sticks.

Risk50/100

GitHub health 37/100. no security policy. 87 open issues make this testable, but not something to trust blind.

What You Are Adopting

AI Agent

Universal

Model

Multiple

Build Time

Minutes

Test This In Your Stack

One command inClean rollbackLow commitment
settingsRegistryAdds a named entry to Claude config. One command to remove.

Fastest way to find out if Unla belongs in your setup.

Copy the install command, run a real test, and back it out cleanly if it slows you down.

Try now
claude mcp add unla -- npx unla

Run this first. You will know quickly if the workflow earns a permanent slot.

Back out
claude mcp remove unla

No messy cleanup loop. If it misses, remove it and keep moving.

Install Location

~/  └─ .claude.json    └─ mcp_servers/      └─ unla ← registers here

About

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.. An open-source mcp server for the AI coding ecosystem.

README

Unla - MCP Gateway

🚀 Instantly transform your existing MCP Servers and APIs into MCP endpoints — without changing a line of code.

English 简体中文 繁體中文 Release Docs Ask DeepWiki Discord Go Report Card Snyk Security LLMAPIS


⚡ 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.

MCP.Gateway.Quick.Start.mp4

🔧 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:

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 »


🚀 Core Features

🔌 Protocol & Proxy Capabilities

  • Support for converting RESTful APIs to MCP Server — Client → MCP Gateway → APIs
  • Support proxying MCP services — Client → MCP Gateway → MCP Servers
  • Support for converting gRPC to MCP Server — Client → MCP Gateway → gRPC
  • Support for converting WebSocket to MCP Server — Client → MCP Gateway → WebSocket
  • Support for MCP SSE
  • Support for MCP Streamable HTTP
  • Support for MCP responses including text, images, and audio

🧠 Session & Multi-Tenant Support

  • Persistent and recoverable session support
  • Multi-tenant support
  • Support for grouping and aggregating MCP servers

🛠 Configuration & Management

  • Automatic configuration fetching and seamless hot-reloading
  • Configuration persistence (Disk/SQLite/PostgreSQL/MySQL)
  • Configuration sync via OS Signals, HTTP, or Redis PubSub
  • Version control for configuration

🔐 Security & Authentication

  • OAuth-based pre-authentication support for MCP Servers

🖥 User Interface

  • Intuitive and lightweight management UI

📦 Deployment & Operations

  • Multi-replica service support
  • Docker support
  • Kubernetes and Helm deployment support

📚 Documentation

For more usage patterns, configuration examples, and integration guides, please visit:

👉 https://docs.unla.amoylab.com


📄 License

This project is licensed under the MIT License.

💬 Join Our WeChat Community

Scan the QR code below to add us on WeChat. Please include a note: mcp-gateway, mcpgw or unla.

WeChat QR Code

📈 Star History

Star History Chart

Tech Stack

GoLLMSQLitePostgreSQLMySQLRedisDockerKubernetes

Installation

Unla supports a ready-to-run Docker deployment. Full deployment and configuration instructions are available in the docs .

Open Live ProjectAudit Repo

Reviews0

Log in to write a review.

ActiveLast commit 7d ago
bug_report87open issues
Submitted April 15, 2025

auto_awesomeYour strongest next moves after Unla