xTag

Overview

Full name
docker.io/huangjunsen/xiaozhi-mcphub
Registry
docker.io
Namespace
huangjunsen
Repository
xiaozhi-mcphub
Cached tags
8
Last synced
07/06/2026, 12:38 PM

Introduction

小智 AI 设备的 MCP Hub 聚合镜像，统一管理 Model Context Protocol 工具端点，为小智语音助手提供可扩展插件能力。

Details

huangjunsen/xiaozhi-mcphub 运行 MCP 协议路由与注册中心，聚合多个 MCP Server 供小智（xiaozhi）客户端 discovery 与调用。典型用于智能家居或语音助手生态扩展天气、日历、IoT 等工具。与通用 mcp-proxy 相比预置小智集成；生产固定 tag、工具凭据经 env/Secret 注入并限制 Hub 仅内网可达，审计各 MCP Server 权限范围。

快速启动

docker run -d --name xiaozhi-mcphub \
  -p 3000:3000 \
  -v $(pwd)/config.yaml:/app/config.yaml \
  docker.io/huangjunsen/xiaozhi-mcphub:latest

推荐实践

docker run -d --name xiaozhi-mcphub \
  --restart unless-stopped \
  -p 3000:3000 \
  -v /data/mcphub/config.yaml:/app/config.yaml:ro \
  -e LOG_LEVEL=info \
  docker.io/huangjunsen/xiaozhi-mcphub:1.0.0

核心参数说明

  • -p 3000:3000 — MCP Hub HTTP/gRPC 端口
  • -v .../config.yaml:... — MCP Server 注册与路由配置
  • -e LOG_LEVEL — 日志级别
  • --restart unless-stopped — Hub 持续在线
  • 固定 tag — 与小智客户端协议版本 pin
  • 安全 — 配置文件含 API Key 须只读挂载

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: xiaozhi-mcphub
spec:
  replicas: 2
  selector:
    matchLabels:
      app: xiaozhi-mcphub
  template:
    metadata:
      labels:
        app: xiaozhi-mcphub
    spec:
      containers:
        - name: mcphub
          image: docker.io/huangjunsen/xiaozhi-mcphub:1.0.0
          ports:
            - containerPort: 3000
          volumeMounts:
            - name: config
              mountPath: /app/config.yaml
              subPath: config.yaml
      volumes:
        - name: config
          secret:
            secretName: mcphub-config
---
apiVersion: v1
kind: Service
metadata:
  name: xiaozhi-mcphub
spec:
  selector:
    app: xiaozhi-mcphub
  ports:
    - port: 3000
      targetPort: 3000

MCP 配置放 Secret；NetworkPolicy 限制仅小智客户端 namespace 访问。

Latest tags (20)

View all 8 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/huangjunsen/xiaozhi-mcphub
:latest
linux/amd64linux/arm64
2025/09/19 10:20802.5 MBsha256:7c65b30805f3…
docker.io/huangjunsen/xiaozhi-mcphub
:1.0.3
linux/amd64linux/arm64
2025/09/19 10:20802.5 MBsha256:7c65b30805f3…
docker.io/huangjunsen/xiaozhi-mcphub
:1.0.2
linux/amd64linux/arm64
2025/08/29 17:33799.3 MBsha256:ee66d803bbe0…
docker.io/huangjunsen/xiaozhi-mcphub
:latest-full
linux/amd64linux/arm64
2025/08/01 16:57714.4 MBsha256:f9d7d2640fa2…
docker.io/huangjunsen/xiaozhi-mcphub
:1.0.1-full
linux/amd64linux/arm64
2025/08/01 16:57714.4 MBsha256:f9d7d2640fa2…
docker.io/huangjunsen/xiaozhi-mcphub
:1.0.1
linux/amd64linux/arm64
2025/08/01 16:56353.7 MBsha256:7e23af602f28…
docker.io/huangjunsen/xiaozhi-mcphub
:1.0.0-full
linux/amd64linux/arm64
2025/07/15 14:32711.6 MBsha256:59a8b39b84c9…
docker.io/huangjunsen/xiaozhi-mcphub
:1.0.0
linux/amd64linux/arm64
2025/07/15 14:31350.7 MBsha256:4793c0e9db95…