中文版 |英語

xiaozhi-mcphubは、Xiaozhi AIプラットフォーム向けに最適化されたMCP(Model Context Protocol)ブリッジおよび管理コンソールです。マルチエンドポイント管理、自動再接続、ベクターベースのスマートルーティング、OpenAPI互換アクセスを提供します。

🚀 主な特徴

• 強化されたシャオジー統合:

• マルチエンドポイント管理:複数のXiaozhiエンドポイントによる双方向WebSocket接続(有効化・無効、編集、再接続、ステータスクエリ)。

• スマート再接続:高速再接続モード、指数関数的なバックオフ、スリープウィンドウ付き無限リトライ — すべて環境変数で設定可能。

• ツール同期:サーバーツールが変更されると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.