跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.unla.amoylab.com/llms.txt

Use this file to discover all available pages before exploring further.

​
一鍵啟動 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

​
存取與設定

1

進入網頁介面

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

新增 MCP 伺服器

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

​
可用端點

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

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 客戶端（推薦）

​
進階設定（可選）

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

建立目錄並下載設定檔

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
2

以設定檔方式啟動

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
以掛載設定檔方式啟動，可精細控制各服務參數。詳細設定請參見 設定說明文件。