ghcr.io/amoylab/unla/allinone:latest

Unla - MCP Gateway

🚀 立即将您现有的 MCP Servers 和 APIs 转换为 MCP 端点 — 无需修改任何代码。

---

---

✨ 什么是 Unla？

Unla 是一款用 Go 语言编写的轻量级高可用网关服务。它使个人和组织能够通过配置将其现有的 MCP Servers 和 APIs 转换为符合 MCP 协议 的服务 — 全程零代码修改。

🔧 核心设计原则

• ✅ 零侵入性：平台无关，支持部署在裸机、VM、ECS、Kubernetes 等环境，无需修改现有基础设施
• 🔄 配置驱动：通过 YAML 配置将遗留 API 转换为 MCP Servers — 无需编写代码
• 🪶 轻量级高效：在不影响性能和可用性的前提下，设计为最小资源占用
• 🧭 内置管理 UI：即用型 Web 界面简化设置并降低运维成本

---

🚀 快速开始

Unla 支持开箱即用的 Docker 部署。完整的部署和配置说明可在 文档 中查看。

使用 Docker 快速启动

配置环境变量：

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"

启动容器：

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

访问与配置

1. 访问 Web 界面：

   • 在浏览器中打开 http://localhost:8080/
   • 使用您配置的管理员凭据登录

2. 添加 MCP Server：

   • 复制配置文件：https://github.com/amoylab/unla/blob/main/configs/proxy-mock-server.yaml
   • 在 Web 界面中点击 "Add MCP Server"
   • 粘贴配置并保存

可用端点

配置完成后，服务将在以下端点可用：

• MCP SSE：http://localhost:5235/mcp/user/sse
• MCP SSE 消息：http://localhost:5235/mcp/user/message
• MCP 流式 HTTP：http://localhost:5235/mcp/user/mcp

使用带 /sse 或 /mcp 后缀的 URL 配置您的 MCP Client 即可开始使用。

测试

您可以通过以下方式测试服务：

1. Web 界面中的 MCP Chat 页面
2. 您自己的 MCP Client（推荐）

📖 阅读完整指南 → 快速开始 »

---

🚀 核心功能

🔌 协议与代理能力

• 支持将 RESTful APIs 转换为 MCP Server — 客户端 → MCP 网关 → APIs
• 支持代理 MCP 服务 — 客户端 → MCP 网关 → MCP Servers
• 支持将 gRPC 转换为 MCP Server — 客户端 → MCP 网关 → gRPC
• 支持将 WebSocket 转换为 MCP Server — 客户端 → MCP 网关 → WebSocket
• 支持 MCP SSE
• 支持 MCP 流式 HTTP
• 支持包含文本、图片和音频的 MCP 响应

🧠 会话与多租户支持

• 持久化和可恢复的会话支持
• 多租户支持
• 支持 MCP 服务器分组和聚合

🛠 配置与管理

• 自动配置获取和无缝热重载
• 配置持久化（磁盘/SQLite/PostgreSQL/MySQL）
• 通过 OS 信号、HTTP 或 Redis PubSub 进行配置同步
• 配置版本控制

🔐 安全与认证

• 支持基于 OAuth 的 MCP Servers 预认证

🖥 用户界面

• 直观轻量的管理 UI

📦 部署与运维

• 多副本服务支持
• Docker 支持
• Kubernetes 和 Helm 部署支持

---

📚 文档

如需更多使用模式、配置示例和集成指南，请访问：

👉 [*]

---

📄 许可证

本项目基于 MIT License 许可。

💬 加入我们的微信社群

扫描下方***添加我们的微信，请备注：mcp-gateway、mcpgw 或 unla。

📈 Star 历史