services:
  mcp-proxy-gateway:
    image: xylplm/mcp-proxy-gateway:latest
    container_name: mcp-proxy-gateway
    restart: unless-stopped
    ports:
      - "8088:8080"
    environment:
      MPG_PG_DSN: "postgres://mcp_gateway_user:你的数据库密码@pgsql:5432/mcp_gateway?sslmode=disable"
      MPG_REDIS_ADDR: "redis:6379"
      MPG_REDIS_PASSWORD: ""
      MPG_DATA_DIR: "/data"
    volumes:
      - ./data:/data

启动后访问：

http://你的NAS地址:8088

先准备数据库

上面的 Compose 假设你已经在 PostgreSQL 中创建了 mcp_gateway 数据库和 mcp_gateway_user 用户。MPG_PG_DSN 是数据库连接串，里面包含用户名、密码、数据库地址、端口和数据库名；详细拆解、创建命令和复用 MS Redis 的写法请看：MCP 网关 Compose 部署。

2. 在网关中接入 Media Saber MCP

部署完成后，需要把 Media Saber 自带的 MCP 服务添加为上游 MCP。请按 MCP 网关接入 MS 服务完成以下配置：

配置项	推荐值
传输方式	远程 HTTP
服务地址	`http://你的MS地址:端口/message`
认证方式	Bearer Token
凭证	Media Saber API KEY

确认网关能同步出 Media Saber 工具后，再继续配置小智接入。

3. 在小智控制台获取 MCP 接入点

打开小智 AI 控制台：

https://xiaozhi.me/console/agents

按下面步骤操作：

进入 小智 AI 控制台 → 智能体。
找到需要配置的智能体。
点击该智能体的 配置角色 按钮，进入配置页。
选择下方的 MCP 设置。
可以按需勾选你喜欢的官方 MCP 设置。
在 自定义服务 区域点击 获取 MCP 接入点。
复制生成的 MCP 接入点地址。

接入点地址请妥善保存

MCP 接入点地址用于让网关连接到你的小智智能体，请不要公开贴到论坛、群聊或公开仓库中。

4. 在 MCP Proxy Gateway 填写小智接入

API 服务 → 第三方对接 → 小智接入

按下面填写：

配置项	说明
启用小智接入	打开开关，保存后网关会立即尝试连接
接入点地址	粘贴小智控制台复制的 MCP 接入点地址，通常是 `wss://...`
对接模式	建议选择「全量模式」

填写完成后点击 保存小智接入。

小智接入建议使用全量模式

小智 MCP 当前更适合直接接收完整工具列表，不建议在小智接入里使用智能模式。智能模式主要适合 Claude Code 等支持先发现、再按需调用网关工具的客户端；小智场景请优先选择「全量模式」，避免工具不可见或调用异常。