mcp-endpoint

The MCP Endpoint Server acts as a lightweight, high-performance MCP registration center built on WebSocket. It enables Xiaozhi devices and tooling to register MCP services, forward messages between tools and Xiaozhi endpoints, manage connections, and expose health and connection statistics. This server is designed to be run via Docker for ease of deployment and maintenance. Once running, clients can connect via WebSocket to register MCP services and participate in message routing between endpoints and controllers.

To use it, deploy the Docker image and ensure network access between the Xiaozhi server and the MCP endpoint. Use the provided registration interface to define MCP services, then start clients and tools that rely on MCP to discover and communicate with registered services. The server will handle connection management, message forwarding, and basic health checks so you can monitor the status of connected clients and services.

Prerequisites:

• Docker installed and running
• Basic familiarity with Docker commands

Step 1: Pull the MCP Endpoint Server image

docker pull image-name

Step 2: Run the MCP Endpoint Server

docker run -i image-name

Step 3: Verify the server is up

• Check container logs for startup messages
• Ensure network connectivity between Xiaozhi server and the MCP endpoint

Step 4: (Optional) Configure persistent storage or environment variables as needed in your deployment environment.

Tips:

• This server is designed as a Docker deployment for simplicity and scalability. If you need to customize configuration, look for a mounted config file or environment variables supported by the image.
• Monitor health and connection statistics via the provided endpoints in the container; implement retries in clients if connections drop.
• Ensure proper network access between Xiaozhi devices, tools, and the MCP Endpoint Server to avoid failed registrations or message routing issues.