快速開始

一鍵啟動 MCP 閘道

所有服務設定參數皆可透過環境變數注入改動

請注意下列環境變數需設定（其他環境變數請依實際狀況調整）：

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"

GHCR 映像檔

使用 GitHub Container Registry 映像檔：

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

阿里雲映像檔

在中國地區設備可透過阿里雲倉庫拉取：

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 \
  registry.ap-southeast-1.aliyuncs.com/amoylab/unla-allinone:latest

存取與設定

進入網頁介面

請在瀏覽器打開 http://localhost:8080/，並以管理員帳號登入

新增 MCP 伺服器

複製設定檔：https://github.com/AmoyLab/Unla/blob/main/configs/proxy-mock-server.yaml
在網頁介面點選「新增 MCP Server」
貼上設定保存即可

可用端點

設定完成後，服務將提供以下端點：

MCP 端點

MCP SSE: http://localhost:5235/gateway/user/sse
MCP SSE 訊息: http://localhost:5235/gateway/user/message
MCP Streamable HTTP: http://localhost:5235/gateway/user/mcp

在 MCP Client 設定 URL 時請加上 /sse 或 /mcp 後綴，即可開始使用服務。

測試方式

您可採用下列兩種測試方式：

網頁介面測試

在網頁的 MCP Chat 頁面測試服務

MCP 客戶端測試

使用您的 MCP 客戶端（推薦）

進階設定（可選）

若需更細緻的設定控制，可使用掛載設定檔方式啟動：

建立目錄並下載設定檔

mkdir -p unla/{configs,data}
cd unla/
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/configs/apiserver.yaml -o configs/apiserver.yaml
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/configs/mcp-gateway.yaml -o configs/mcp-gateway.yaml
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/.env.example -o .env.allinone

以設定檔方式啟動

docker run -d \
           --name unla \
           -p 8080:80 \
           -p 5234:5234 \
           -p 5235:5235 \
           -p 5335:5335 \
           -p 5236:5236 \
           -e ENV=production \
           -v $(pwd)/configs:/app/configs \
           -v $(pwd)/data:/app/data \
           -v $(pwd)/.env.allinone:/app/.env \
           --restart unless-stopped \
           ghcr.io/amoylab/unla/allinone:latest

以掛載設定檔方式啟動，可精細控制各服務參數。詳細設定請參見設定說明文件。

安裝部署

配置說明

Web 配置

客戶端使用

開發文檔

API 文檔

端點示例

快速開始

一鍵啟動 MCP 閘道

GHCR 映像檔

阿里雲映像檔

存取與設定

可用端點

MCP 端點

測試方式

網頁介面測試

MCP 客戶端測試

進階設定（可選）

​一鍵啟動 MCP 閘道

​GHCR 映像檔

​阿里雲映像檔

​存取與設定

​可用端點

MCP 端點

​測試方式

網頁介面測試

MCP 客戶端測試

​進階設定（可選）

一鍵啟動 MCP 閘道

GHCR 映像檔

阿里雲映像檔

存取與設定

可用端點

測試方式

進階設定（可選）