Unla - MCP 网关

🚀 无需修改任何代码，即可将您现有的 MCP 服务器和 API 即时转换为 MCP 终端点。

---

⚡ 注意: Unla 处于快速开发中！我们致力于保持向后兼容性，但无法 100% 保证。请在升级时仔细检查版本变更。由于迭代速度较快，文档更新有时会滞后。如果您遇到任何问题，请随时通过 Discord 或 Issues 搜索或寻求帮助 ❤️

---

✨ Unla 是什么？

Unla 是一个用 Go 编写的轻量级、高可用的网关服务。它使个人和组织能够通过配置将现有的 MCP 服务器和 API 转换为符合 MCP 协议的服务——完全无需修改代码。

https://github.com/user-attachments/assets/69480eda-7aa7-4be7-9bc7-cae57fe16c54

🔧 核心设计原则

• ✅ 零侵入：平台无关，支持在裸机、虚拟机、ECS、Kubernetes 等环境中部署，无需修改现有基础设施
• 🔄 配置驱动：使用 YAML 配置将旧版 API 转换为 MCP 服务器——无需编写任何代码
• 🪶 轻量高效：专为最小化资源占用而设计，同时不牺牲性能和可用性
• 🧭 内置管理界面：开箱即用的 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 服务器：

   • 复制配置：https://github.com/amoylab/unla/blob/main/configs/proxy-mock-server.yaml
   • 在 Web 界面中点击“添加 MCP 服务器”
   • 粘贴配置并保存

可用端点

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

• 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 客户端，即可开始使用。

测试

您可以使用以下方式测试服务：

1. Web 界面中的 MCP 聊天页面
2. 您自己的 MCP 客户端（推荐）

📖 阅读完整指南 → 快速入门 »

---

🚀 核心功能

🔌 协议与代理能力

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

🧠 会话与多租户支持

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

🛠 配置与管理

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

🔐 安全与认证

• 支持基于 OAuth 的 MCP 服务器预认证

🖥 用户界面

• 直观且轻量的管理界面

📦 部署与运维

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

---

📚 文档

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

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

---

📄 许可证

本项目采用 MIT 许可证 许可。

💬 加入我们的微信社区

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

📈 星标历史

Unla 快速上手指南

Unla 是一个轻量级、高可用的 Go 语言网关服务，旨在通过纯配置方式（零代码修改），将现有的 MCP Server 或普通 API 快速转换为符合 MCP 协议 的标准端点。

环境准备

• 操作系统：支持 Linux、macOS、Windows（推荐在 Linux 服务器或容器环境中部署）。
• 运行依赖：
  • Docker：版本 20.10+（推荐使用 Docker Compose 或直接使用 docker run）。
  • 网络要求：需开放以下端口（可根据需求映射）：
    • 8080：Web 管理界面
    • 5234 - 5236：MCP 服务通信端口
• 前置知识：了解基本的 Docker 命令及 MCP 客户端配置方法。

💡 提示：本项目目前主要通过 Docker 镜像分发，无需单独安装 Go 环境或编译源码。

安装步骤

Unla 提供了一体化（all-in-one）的 Docker 镜像，只需几条命令即可启动。

1. 配置环境变量

为了安全起见，请先设置 JWT 密钥和管理员账号密码。在终端执行以下命令（请替换为强随机字符串）：

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"

2. 启动 Docker 容器

执行以下命令拉取并运行最新版本的 Unla 镜像：

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

🚀 加速建议：如果拉取 ghcr.io 镜像速度较慢，可尝试配置 Docker 国内镜像加速器，或使用代理网络。

基本使用

启动成功后，即可通过 Web 界面进行配置并连接 MCP 客户端。

1. 访问管理后台

• 打开浏览器访问：http://localhost:8080/
• 使用步骤 1 中设置的 SUPER_ADMIN_USERNAME 和 SUPER_ADMIN_PASSWORD 登录。

2. 添加 MCP 服务

1. 获取示例配置文件内容（这是一个模拟服务器配置）：
   • 源地址：https://github.com/amoylab/unla/blob/main/configs/proxy-mock-server.yaml
   • 点击 Raw 按钮复制全部内容。
2. 在 Unla 管理界面点击 "Add MCP Server"。
3. 将复制的配置内容粘贴到输入框中，保存即可。

3. 连接 MCP 客户端

配置完成后，Unla 会暴露以下标准端点供客户端连接：

• MCP SSE: http://localhost:5235/mcp/user/sse
• MCP Streamable HTTP: http://localhost:5235/mcp/user/mcp

配置您的 MCP Client： 在您的 MCP 客户端（如 Claude Desktop, Zed, 或其他支持 MCP 的工具）中，添加新的 Server 配置，URL 指向上述带有 /sse 或 /mcp 后缀的地址。

4. 验证测试

• 方式一：直接使用 Unla Web 界面内置的 "MCP Chat" 页面进行对话测试。
• 方式二：在您常用的 MCP 客户端中调用已配置的工具，观察是否返回预期结果。

---

📖 进阶文档：更多高级配置、多租户管理及持久化方案，请访问官方文档：https://docs.unla.amoylab.com