Multiservermcp

🚀 Multi-Server MCP Framework

A multi-connection MCP server framework based on SSE, supporting long - connection communication. It provides context and function expansion capabilities for AI assistants. Currently, only the SSE mode is supported.

🚀 Multi-Server MCP — Empowering AI assistants and expanding their capabilities!

The Multi-Server MCP aims to provide a powerful server framework that allows a single server to connect to multiple clients, enabling efficient management of tools and permissions.

✨ Features

• Support multiple clients to connect to a single server in SSE mode.
• Implement tool and permission management through URL grouping.
• Built-in heartbeat mechanism to ensure connection stability.
• Simplified tool registration process.
• Fully compatible with the MCP protocol.
• Global session management with a SessionManager instance.
• Provide a global function to get request query parameters.

📦 Installation

Install using npm:

npm install multi-server-mcp

🚀 Quick Start

Import Dependencies

Import the zod library for type definition in your project:

import { z } from 'zod';

Usage Examples

Basic Usage

Create a basic Multi-Server MCP instance:

const mcp = new MultiServerMCP();

// Register a tool
mcp.tool('echo', (input, sessionId) => {
    return input;
});

// Register a resource
mcp.resource('time', () => {
    return new Date().toISOString();
});

// Start the server
await mcp.start(5000);

📚 Documentation

Supported Tool Types

• Regular tools: server.tool()
• Resource tools: server.resource()
• Prompt tools: server.prompt()

Session Management

Implement global session management through SessionManager:

// Get the instance
const sessionManager = SessionManager.getInstance();

// Get the client context
const clientContext = sessionManager.getClientContext(sessionId);

// Get the request query parameters
const reqQuery = sessionManager.getReqQuery(sessionId);

// Get the number of currently active sessions
const sessionCount = sessionManager.getSessionCount();

🛠️ Contribution Guidelines

Contributions, issue reports, and feature requests are welcome!

📄 License

MIT