MCP Router

# MCP Router MCP Router is a service discovery and proxy for MCP (Model Control Protocol) services. It allows you to register, discover, and execute tools on remote MCP servers. ## Features 1. **Service Discovery**: Register and search for MCP services using vector-based similarity search 2. **Tool Execution Proxy**: Execute tools on remote MCP servers through the router 3. **MCP Compliance**: Fully compliant with the MCP protocol specification ## Architecture The MCP Router consists of two core modules: 1. **MCP Data Plane**: The frontend that interacts with MCP clients, providing service discovery, registration, and tool execution proxying 2. **MCP Discovery Service**: The backend that uses Alibaba Cloud's vector database and embedding models for intelligent search and management of registered MCP services ## Prerequisites - Python 3.11 or higher - Access to Alibaba Cloud DashScope and DashVector services - API keys for DashScope and DashVector ## Installation 1. Clone the repository: ```bash git clone <repository-url> cd mcp-router ``` 2. Install dependencies using uv: ```bash uv add pydantic httpx dashscope dashvector python-dotenv ``` 3. Set up environment variables in `.env`: ```env DASHSCOPE_API_KEY=your_dashscope_api_key DASHVECTOR_API_KEY=your_dashvector_api_key DASHVECTOR_ENDPOINT=your_dashvector_endpoint COLLECTION_NAME=mcp_services_collection EMBEDDING_DIMENSION=1024 ``` ## Usage Run the MCP Router server: ```bash uv run python mcp_router.py ``` ## Tools The MCP Router provides three tools: 1. **search_mcp_server**: Search for registered MCP servers based on a query 2. **add_mcp_server**: Register a new MCP server with the discovery service 3. **exec_mcp_tool**: Execute a tool on a target MCP server ## Development ### Code Structure - `mcp_router.py`: Main MCP server implementation (Data Plane) - `discovery_service.py`: Discovery service implementation (Discovery Service) - `config.py`: Configuration management