Multiservermcp

🚀 多服務器MCP框架

多服務器MCP框架是一個基於SSE的多連接MCP服務器框架，支持長連接通信，能為AI助手提供上下文和功能擴展能力。目前，該框架僅支持SSE模式。

🚀 快速開始

多服務器MCP旨在提供一個強大的服務器框架，支持單個服務器連接到多個客戶端，實現工具和權限的高效管理。

引入依賴

在項目中引入zod庫用於類型定義：

import { z } from 'zod';

示例代碼

創建一個基本的多服務器MCP實例：

const mcp = new MultiServerMCP();

// 註冊工具
mcp.tool('echo', (input, sessionId) => {
    return input;
});

// 註冊資源
mcp.resource('time', () => {
    return new Date().toISOString();
});

// 啟動服務器
await mcp.start(5000);

✨ 主要特性

• 支持SSE模式下的多客戶端連接到單個服務器
• 通過URL分組實現工具和權限管理
• 內置心跳機制，確保連接穩定性
• 簡化的工具註冊流程
• 完全兼容MCP協議
• 全局會話管理，提供SessionManager實例
• 提供獲取請求查詢參數的全局函數

📦 安裝指南

使用npm安裝：

npm install multi-server-mcp

📚 詳細文檔

支持的工具類型

• 普通工具：server.tool()
• 資源工具：server.resource()
• 提示工具：server.prompt()

會話管理

通過SessionManager實現全局會話管理：

// 獲取實例
const sessionManager = SessionManager.getInstance();

// 獲取客戶端上下文
const clientContext = sessionManager.getClientContext(sessionId);

// 獲取請求查詢參數
const reqQuery = sessionManager.getReqQuery(sessionId);

// 獲取當前活躍會話數
const sessionCount = sessionManager.getSessionCount();

🛠️ 貢獻指南

歡迎貢獻、問題報告和功能請求！

📄 許可證

MIT