MCP Hub

🚀 MCP Center

The MCP Center is a central system designed to coordinate communication between clients and multiple MCP servers. It offers a unified interface to manage tools, resources, and prompt requests, while maintaining up - to - date capability information for each MCP server.

🚀 Quick Start

The MCP Center is a central system that coordinates communication between clients and multiple MCP servers. It manages tools, resources, and prompt requests through a unified interface and maintains the latest capability information for each MCP server.

✨ Features

Events

The following are the main events supported by the MCP Center:

• hub.start: Indicates the startup of the MCP Center.
• hub.stop: Indicates the shutdown of the MCP Center.
• server.connected: Indicates that an MCP server has connected to the center.
• server.disconnected: Indicates that an MCP server has disconnected from the center.
• tool.request: Represents a client's request for tool execution.
• resource.request: Represents a client's request for resource access.
• prompt.request: Represents a client's request for prompt processing.
• error.log: Records error events.

Architecture Overview

The architecture design of the MCP Center is as follows:

1. Startup and MCP Server Connection

   • Start the MCP Center and initialize the configuration.
   • Attempt to connect to all configured MCP servers.

2. SSE Client Connection Handling

   • Handle Server - Sent Events connections from clients.
   • Publish status updates of the MCP Center, such as startup and shutdown.

3. Tool and Resource Request Routing

   • Validate the validity of client requests.
   • Route requests to the appropriate MCP servers for processing.
   • Handle responses or errors from MCP servers.

4. MCP Server Health Monitoring

   • Regularly check the connection status and capability information of MCP servers.
   • Attempt to reconnect when a fault is detected.

5. Graceful Startup and Shutdown Process

   • Manage the startup and shutdown operations of the MCP Center.
   • Notify all clients during the shutdown process.

Request Handling

The standard process for the MCP Center to handle tool, resource, and prompt requests is as follows:

1. Request Validation

   • Validate the validity and integrity of client requests.
   • Check if the target MCP server is in a normal connection state.

2. Route Requests to MCP Servers

   • Select the appropriate MCP server for processing based on the request type.
   • Send encrypted and signed requests to the target server.

3. Response Handling and Error Management

   • Receive responses or error information from MCP servers.
   • Return the results to the client and log errors when they occur.

📦 Installation

Dependencies

• Node.js version requirement: 18.0.0 or higher
• mcp - marketplace library: Used to provide the functionality of the MCP server marketplace

Marketplace Integration

The MCP Center currently relies on the mcp - marketplace library to implement marketplace functionality. This library provides the following main features:

1. Server Registration

   • Allows MCP servers to register with the center.
   • Provides API interfaces to manage the server list.

2. Capability Verification

   • Verifies whether the capabilities of MCP servers meet the requirements.
   • Maintains the latest server capability information.

3. Request Routing

   • Matches the most suitable MCP server based on client requests.
   • Manages request distribution and response collection.

4. Monitoring and Alerts

   • Implements real - time monitoring of the health status of MCP servers.
   • Triggers an alert mechanism when a fault is detected.

📚 Documentation

To - Do List

• Implement Marketplace Functionality: Complete the integration of the mcp - marketplace into the MCP Center.
• Enhance Error Handling: Improve the error capture and recovery logic in request processing.
• Optimize Performance: Improve the processing capacity under large - scale concurrency.
• Add Logging: Introduce a detailed logging system for easy debugging and monitoring.

📄 License

Acknowledgments

Thanks to the following projects and technologies for their contributions to the development of the MCP Center:

• mcp - marketplace library: Provides powerful marketplace functionality support.
• Node.js team: Provides an efficient and stable runtime environment.
• Open - source community: Offers valuable suggestions and support for the project's continuous development.