MCP Endpoint
xiaozhi mcp接入点服务器，用于自定义mcp服务注册，方便拓展小智服务端工具调用
What is MCP Endpoint?
MCP Endpoint is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to xiaozhi mcp接入点服务器，用于自定义mcp服务注册，方便拓展小智服务端工具调用
xiaozhi mcp接入点服务器，用于自定义mcp服务注册，方便拓展小智服务端工具调用
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- xiaozhi mcp接入点服务器，用于自定义mcp服务注册，方便拓展小智服务端工具调用
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-endpointConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Endpoint
MCP Endpoint Server is a FastAPI and WebSocket-based MCP relay server designed to extend xiaozhi ESP32 smart devices with custom tool capabilities. It acts as a broker between the xiaozhi-esp32-server and one or more upstream MCP servers, aggregating their tool lists into a unified registry and intelligently routing tool calls to the correct backend by tool name. This allows a single xiaozhi voice assistant device to call tools registered across multiple specialised MCP servers — such as calculators, IoT controls, or home automation — through a single connection point without modifying the xiaozhi firmware.
Prerequisites
- Python 3.10 (exactly — the conda environment specifies 3.10)
- conda package manager for environment isolation
- A running xiaozhi-esp32-server instance to connect to
- One or more upstream MCP servers providing the tools you want to expose to your device
- Git to clone the repository
Clone the repository
Clone the mcp-endpoint-server repository to your machine.
git clone https://github.com/xinnan-tech/mcp-endpoint-server.git
cd mcp-endpoint-serverCreate the Python 3.10 conda environment
Create and activate a dedicated conda environment with the required Python version.
conda create -n mcp-endpoint-server python=3.10 -y
conda activate mcp-endpoint-serverInstall Python dependencies
Install all required packages from the requirements file.
pip install -r requirements.txtStart the endpoint server
Launch the MCP endpoint server. It will listen for WebSocket connections from xiaozhi clients and forward tool requests to registered upstream MCP servers.
python main.pyRegister upstream MCP servers
Connect your upstream MCP servers to the endpoint by configuring them in the data/ configuration directory. The server aggregates their tool lists and routes requests automatically.
Connect your xiaozhi device
Point your xiaozhi-esp32-server configuration at the MCP endpoint server's WebSocket address. The device will receive a unified list of all tools from all registered MCP servers.
MCP Endpoint Examples
Client configuration
Example MCP JSON-RPC tool call against the endpoint server — the initialize handshake and a tool invocation for the built-in calculator tool.
{
"id": 0,
"jsonrpc": "2.0",
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {"sampling": {}, "roots": {"listChanged": false}},
"clientInfo": {"name": "xz-mcp-broker", "version": "0.0.1"}
}
}Prompts to try
Example voice or text commands a xiaozhi device user might issue once the endpoint server bridges their tools.
- "Calculate 130000 times 130000"
- "List all available tools registered on the endpoint"
- "What tools can I use right now?"
- "Run the calculator with the expression 2 to the power of 16"
- "Check the health status of the endpoint server"Troubleshooting MCP Endpoint
conda activate fails or environment creation errors out
Ensure conda is initialised for your shell: run conda init zsh (or bash), restart your terminal, and try again. If you see 'conda command not found', add conda to your PATH or use the full path to the conda binary.
python main.py fails with module import errors
Confirm the mcp-endpoint-server conda environment is active (conda activate mcp-endpoint-server) before running. If dependencies are still missing, run pip install -r requirements.txt again from within the activated environment.
xiaozhi device cannot connect to the endpoint server
Check that the server's WebSocket port is not blocked by a firewall. Verify the IP address and port in your xiaozhi-esp32-server configuration match where main.py is listening. Check the logs/ directory for connection error details.
Frequently Asked Questions about MCP Endpoint
What is MCP Endpoint?
MCP Endpoint is a Model Context Protocol (MCP) server that xiaozhi mcp接入点服务器，用于自定义mcp服务注册，方便拓展小智服务端工具调用 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Endpoint?
Follow the installation instructions on the MCP Endpoint GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Endpoint?
MCP Endpoint works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Endpoint free to use?
Yes, MCP Endpoint is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Endpoint Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP Endpoint? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Endpoint in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Endpoint?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.