huangjunsen/xiaozhi-mcphub Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

该镜像为针对小 Zhi AI 集成优化的 MCP（Message Control Protocol）桥接系统，主要用于实现各类设备与小 Zhi AI 平台之间的高效数据交互和通信连接，简化设备接入小 Zhi AI 生态的流程，保障数据传输的稳定性与实时性。

核心功能与特性

• 小 Zhi AI 平台无缝集成：针对小 Zhi AI 平台的通信协议和接口进行深度适配，确保设备与平台间的稳定连接
• 高效数据转发：优化数据传输链路，支持低延迟数据交互，满足实时性要求较高的应用场景
• 多协议转换：兼容 MQTT、HTTP 等常见工业/物联网协议，实现设备端协议与小 Zhi AI 平台协议的自动转换
• 连接管理机制：内置连接状态监控与自动重连功能，保障网络波动时的通信连续性
• 轻量化设计：镜像体积精简，资源占用低，适用于边缘计算设备及嵌入式环境部署

使用场景

• 智能家居设备接入小 Zhi AI 生态，实现语音控制、状态上报及远程管理
• 工业物联网设备（如传感器、控制器）与小 Zhi AI 平台的数据交互，支持 AI 分析与决策支持
• 嵌入式系统集成小 Zhi AI 能力，扩展设备智能化功能（如语音交互、场景联动）
• 需要与小 Zhi AI 平台进行双向通信的各类终端设备（如智能家电、工业控制终端）

使用方法

基本部署（docker run）

bash
docker run -d \
  --name mcp-bridge-xiaozhi \
  -e XIAOZHI_AI_URL="[***]" \
  -e DEVICE_ID="device-***" \
  -e AUTH_TOKEN="your-auth-token" \
  -e PROTOCOL=MQTT \
  -p 1883:1883 \
  your-registry/mcp-bridge-xiaozhi:latest

环境变量说明

docker-compose 配置示例

yaml
version: '3'
services:
  mcp-bridge:
    image: your-registry/mcp-bridge-xiaozhi:latest
    container_name: mcp-bridge-xiaozhi
    restart: always
    environment:
      - XIAOZHI_AI_URL=[***]
      - DEVICE_ID=device-***
      - AUTH_TOKEN=your-auth-token
      - PROTOCOL=MQTT
      - LOG_LEVEL=DEBUG
    ports:
      - "1883:1883"  # MQTT协议端口（根据PROTOCOL配置调整）
    volumes:
      - ./config:/app/config  # 持久化配置文件（如协议参数、证书等）

注意事项

• 确保小 Zhi AI 平台接口地址和认证令牌正确，否则无法建立连接
• 根据设备端实际使用的协议配置 PROTOCOL 参数，确保与设备通信协议兼容
• 生产环境建议通过环境变量或挂载配置文件管理敏感信息（如 AUTH_TOKEN）
• 首次部署后，可通过容器日志（docker logs mcp-bridge-xiaozhi）确认连接状态及数据传输情况