中文版 | Английский

xiaozhi-mcphub — это мост и консоль управления MCP (Model Context Protocol), оптимизированные для платформы Xiaozhi AI. Он обеспечивает управление несколькими конечными точками, автоматическое переподключение, векторную умную маршрутизацию и совместимый с OpenAPI доступ.

🚀 Ключевые особенности

• Улучшенная интеграция Xiaozhi:

• Управление многоконечными точками: Двунаправленные WebSocket соединения с несколькими конечными точками Xiaozhi (включить/отключить, редактировать, переподключить, запросить статус).

• Умное переподключение: режим быстрого повторного подключения, экспоненциальное отключение, бесконечное количество повторных попыток с окном сна — всё это можно настраивать через переменные среды.

• Синхронизация инструментов: Конечные точки Xiaozhi получают уведомления при изменении серверных инструментов, чтобы списки инструментов оставались актуальными.

• Группировка и умная маршрутизация: Конечные точки могут привязываться к группам или использовать [$smart интеллектуальную маршрутизацию.

• Управление MCP (унаследованное и улучшенное):

• Управление стандартными MCP-серверами (stdio / SSE / HTTP режимы).

• Включать/отключать серверы, инструменты и подсказки с описаниями и группировками.

• Унифицированные MCP-вводы, групповые и серверно-специфические конечные точки.

• Консоль и аутентификация:

xiaozhi-mcphub: MCP tool bridge and console optimized for the Xiaozhi AI platform

中文版 | English

xiaozhi-mcphub is an MCP (Model Context Protocol) bridge and management console optimized for the Xiaozhi AI platform. It provides multi-endpoint management, automatic reconnection, vector-based smart routing, and OpenAPI-compatible access.

🚀 Key Features

• Enhanced Xiaozhi Integration:

  • Multi-endpoint management: Bidirectional WebSocket connections with multiple Xiaozhi endpoints (enable/disable, edit, reconnect, status query).
  • Smart reconnection: Fast reconnect mode, exponential backoff, infinite retries with sleep window — all configurable via environment variables.
  • Tool synchronization: Xiaozhi endpoints are notified when server tools change to keep tool lists up-to-date.
  • Grouping and smart routing: Endpoints can bind to groups or use $smart intelligent routing.

• MCP Management (inherited and enhanced):

  • Manage standard MCP servers (stdio / SSE / HTTP modes).
  • Enable/disable servers, tools, and prompts with descriptions and grouping.
  • Unified MCP entry, group entry, and server-specific endpoints.

• Console & Authentication:

  • Frontend console (React + Vite + Tailwind) to manage Servers, Groups, Users, Logs, Settings, Xiaozhi Endpoints, and Market.
  • JWT-based authentication with user context middleware and a built-in admin account.

• OpenAPI & Direct Tool Access:

  • Expose OpenAPI documentation and statistics endpoints.
  • Call specific server tools via OpenAPI-compatible endpoints.

🧩 Main Differences from Upstream

• New Xiaozhi endpoint multi-endpoint management and status (backward compatible, focusing on multi-endpoints).
• New per-endpoint reconnection strategies and global fast-reconnect switch.
• Enhanced $smart intelligent routing (optional) with automatic Xiaozhi linkage.
• Database uses PostgreSQL + pgvector, initializing sample servers and admin by default.

🔧 Quick Start

Method 1: Use DockerHub image (recommended)

# Pull the image
docker pull huangjunsen/xiaozhi-mcphub:latest

# Run (adjust DB URL and password to your environment)
# Use DB_URL (1.1.x). Legacy DATABASE_URL from v1.0.3 is still accepted as a fallback.
docker run -d \
  --name xiaozhi-mcphub \
  -p 3000:3000 \
  -e DB_URL="postgres://xiaozhi:[email protected]:5432/xiaozhi_mcphub" \
  -e SMART_ROUTING_ENABLED="false" \
  -v $(pwd)/data:/app/data \
  huangjunsen/xiaozhi-mcphub:latest

# Open the dashboard
# http://localhost:3000

Optional environment variables:

• BASE_PATH: Deploy under a sub-path (e.g., /mcphub).
• JWT_SECRET: JWT secret (recommended to set explicitly in production).
• SMART_ROUTING_ENABLED: Enable/disable smart routing (default “false”).
• OPENAI_API_KEY, OPENAI_API_BASE_URL, OPENAI_API_EMBEDDING_MODEL: Required when enabling smart routing.