npm - @xiaozhi-client/mcp-core - Versions diffs - 1.9.7-beta.9 → 1.9.8-beta.0 - Mend

@xiaozhi-client/mcp-core 1.9.7-beta.9 → 1.9.8-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -10,7 +10,7 @@
 `@xiaozhi-client/mcp-core` 是一个完全独立的 MCP（Model Context Protocol）核心实现库，提供：
 - **零业务耦合** - 纯粹的 MCP 协议实现，无任何业务逻辑依赖
-- **多传输协议支持** - 支持 STDIO、SSE、StreamableHTTP 三种传输方式
+- **多传输协议支持** - 支持 STDIO、SSE、HTTP 三种传输方式
 - **灵活的事件系统** - 基于回调的事件机制，易于集成
 - **完整的类型定义** - TypeScript 严格模式，提供完整的类型支持
 - **生产就绪** - 经过充分测试，可直接用于生产环境
@@ -31,7 +31,7 @@
 |------|------|----------|
 | **STDIO** | 标准输入输出通信 | 本地进程通信 |
 | **SSE** | Server-Sent Events | 单向服务器推送 |
-| **StreamableHTTP** | 流式 HTTP 通信 | 现代 HTTP/2 场景 |
+| **HTTP** | HTTP 通信 | 现代 HTTP 场景 |
 ## 安装
@@ -179,7 +179,7 @@ import { MCPConnection, MCPTransportType } from '@xiaozhi-client/mcp-core';
 // 1. 创建连接配置
 const config = {
   name: 'my-mcp-service',
-  type: MCPTransportType.STREAMABLE_HTTP,
+  type: MCPTransportType.HTTP,
   url: 'https://api.example.com/mcp',
   apiKey: 'your-api-key'
 };
@@ -330,12 +330,6 @@ interface MCPServiceConfig {
   // 认证配置
   apiKey?: string;                       // API 密钥
   headers?: Record<string, string>;      // 自定义请求头
-  // 超时配置
-  timeout?: number;                      // 连接超时（毫秒，默认 10000）
-  // 重试配置
-  retryAttempts?: number;                // 重试次数
 }
 ```
@@ -344,7 +338,7 @@ interface MCPServiceConfig {
 如果不指定 `type`，库会自动根据配置推断：
 - 有 `command` 字段 → `MCPTransportType.STDIO`
-- 有 `url` 字段 → `MCPTransportType.STREAMABLE_HTTP` 或 `MCPTransportType.SSE`
+- 有 `url` 字段 → `MCPTransportType.HTTP` 或 `MCPTransportType.SSE`
 ## 工具调用
@@ -451,10 +445,9 @@ class MyMCPClient {
   constructor(url: string, apiKey: string) {
     const config = {
       name: 'my-service',
-      type: MCPTransportType.STREAMABLE_HTTP,
+      type: MCPTransportType.HTTP,
       url,
-      apiKey,
-      timeout: 30000
+      apiKey
     };
     const callbacks = {
@@ -687,7 +680,7 @@ await connection.callTool(name, params); // 可能抛出异常
 const config = {
   name: 'service',
   url: 'https://api.example.com'
-  // type 会自动推断为 STREAMABLE_HTTP
+  // type 会自动推断为 HTTP
 };
 // ❌ 避免：手动指定容易出错的类型
@@ -705,17 +698,7 @@ const config = {
 **A:**
 - **本地进程** → 使用 `STDIO`
 - **单向推送** → 使用 `SSE`
-- **现代 HTTP** → 使用 `StreamableHTTP`（推荐）
-### Q: 连接超时如何处理？
-**A:** 在配置中设置 `timeout` 字段（单位：毫秒）：
-```typescript
-{
-  timeout: 30000  // 30 秒超时
-}
-```
+- **现代 HTTP** → 使用 `HTTP`（推荐）
 ### Q: 如何处理连接失败？

package/dist/index.d.ts CHANGED Viewed

@@ -21,8 +21,17 @@ type MCPServerTransport = StdioClientTransport | SSEClientTransport | Streamable
 declare enum MCPTransportType {
     STDIO = "stdio",
     SSE = "sse",
-    STREAMABLE_HTTP = "streamable-http"
+    HTTP = "http"
 }
+/**
+ * 传输类型字符串字面量
+ * 方便外部用户直接使用字符串而不需要导入枚举
+ */
+type MCPTransportTypeString = "stdio" | "sse" | "http";
+/**
+ * 传输类型输入值（枚举或字符串字面量）
+ */
+type MCPTransportTypeInput = MCPTransportType | MCPTransportTypeString;
 /**
  * MCP 服务事件回调接口
  * 用于替代 EventBus 依赖，提供灵活的事件处理机制
@@ -58,21 +67,32 @@ interface ModelScopeSSEOptions {
 }
 /**
  * MCP 服务配置接口
- * 包含所有 MCP 服务的配置选项
+ * 包含所有 MCP 服务的配置选项（不包含服务名称）
+ *
+ * @description
+ * 与 MCP 官方配置格式保持一致，支持三种传输类型：
+ * - stdio: 本地进程通信 { command, args, env }
+ * - sse: Server-Sent Events { url, headers }
+ * - http: Streamable HTTP { url, headers }
+ *
+ * 向后兼容：自动将 streamable-http/streamable_http/streamableHttp 转换为 http
  */
 interface MCPServiceConfig {
-    name: string;
-    type?: MCPTransportType;
+    type?: MCPTransportTypeInput;
     command?: string;
     args?: string[];
     env?: Record<string, string>;
     url?: string;
     apiKey?: string;
     headers?: Record<string, string>;
-    modelScopeAuth?: boolean;
     customSSEOptions?: ModelScopeSSEOptions;
-    timeout?: number;
-    retryAttempts?: number;
+}
+/**
+ * 内部使用的 MCP 服务配置接口（包含 name 字段）
+ * 用于 TransportFactory 等内部函数
+ */
+interface InternalMCPServiceConfig extends MCPServiceConfig {
+    name: string;
 }
 /**
  * 连接状态枚举
@@ -259,6 +279,7 @@ declare class ToolCallError extends Error {
  * 负责管理单个 MCP 服务的连接、工具管理和调用
  */
 declare class MCPConnection {
+    private name;
     private config;
     private client;
     private transport;
@@ -267,7 +288,7 @@ declare class MCPConnection {
     private connectionTimeout;
     private initialized;
     private callbacks?;
-    constructor(config: MCPServiceConfig, callbacks?: MCPServiceEventCallbacks);
+    constructor(name: string, config: MCPServiceConfig, callbacks?: MCPServiceEventCallbacks);
     /**
      * 验证配置
      */
@@ -311,7 +332,9 @@ declare class MCPConnection {
     /**
      * 获取服务配置
      */
-    getConfig(): MCPServiceConfig;
+    getConfig(): MCPServiceConfig & {
+        name: string;
+    };
     /**
      * 获取服务状态
      */
@@ -327,11 +350,6 @@ declare class MCPConnection {
  * 提供简洁的 API 来管理多个 MCP 服务
  */
-/**
- * 用户友好的传输类型
- * 用于简化和标准化用户输入
- */
-type UserFriendlyTransportType = "stdio" | "sse" | "http" | MCPTransportType;
 /**
  * MCP 服务管理器
  * 提供简洁的 API 来管理多个 MCP 服务
@@ -387,9 +405,7 @@ declare class MCPManager extends EventEmitter {
      * });
      * ```
      */
-    addServer(name: string, config: Omit<MCPServiceConfig, "name"> & {
-        type?: UserFriendlyTransportType;
-    }): void;
+    addServer(name: string, config: MCPServiceConfig): void;
     /**
      * 移除服务器配置
      * @param name 服务器名称
@@ -517,14 +533,16 @@ declare class MCPManager extends EventEmitter {
 /**
  * 创建 transport 实例
- * @param config MCP 服务配置
+ * @param config MCP 服务配置（包含 name）
  * @returns transport 实例
  */
-declare function createTransport(config: MCPServiceConfig): MCPServerTransport;
+declare function createTransport(config: InternalMCPServiceConfig): MCPServerTransport;
 /**
  * 验证配置
+ * 注意：name 验证已在 MCPConnection 构造函数中进行
+ * @param config MCP 服务配置（包含 name）
  */
-declare function validateConfig(config: MCPServiceConfig): void;
+declare function validateConfig(config: InternalMCPServiceConfig): void;
 /**
  * 获取支持的传输类型列表
  */
@@ -540,7 +558,15 @@ declare const TransportFactory: {
 /**
  * MCP 服务器配置 Type 字段标准化工具
- * 支持将各种 type 字段格式转换为标准的中划线格式
+ * 支持将各种 type 字段格式转换为 MCP 官方标准格式
+ *
+ * @description
+ * 标准格式与 MCP 官方保持一致：
+ * - stdio: 本地进程通信
+ * - sse: Server-Sent Events
+ * - http: Streamable HTTP（推荐使用 http 而非 streamable-http）
+ *
+ * 向后兼容：自动转换各种变体格式
  */
 /**
  * MCP 服务器配置的基础接口
@@ -555,11 +581,24 @@ interface MCPBaseConfig {
  */
 declare namespace TypeFieldNormalizer {
     /**
-     * 标准化type字段格式
-     * 支持将各种格式转换为标准的中划线格式
+     * 标准化 type 字段格式
+     *
+     * 支持的转换：
+     * - http 变体：http → http（标准值）
+     * - streamable-http → http
+     * - streamable_http → http
+     * - streamableHttp → http
+     * - sse 变体：sse → sse（标准值）
+     * - s_se → sse
+     * - s-se → sse
+     * - stdio 变体：stdio → stdio（标准值）
      */
     function normalizeTypeField<T extends MCPBaseConfig>(config: T): T;
     function normalizeTypeField(config: unknown): unknown;
+    /**
+     * 标准化单个 type 值
+     */
+    function normalizeTypeValue(type: string): string;
 }
 /**
  * 导出便捷函数
@@ -582,9 +621,10 @@ declare function inferTransportTypeFromUrl(url: string, options?: {
  * 完整的配置类型推断（包括 command 字段）
  *
  * @param config - MCP 服务配置
+ * @param serviceName - 服务名称（用于日志输出）
  * @returns 完整的配置对象，包含推断出的类型
  */
-declare function inferTransportTypeFromConfig(config: MCPServiceConfig): MCPServiceConfig;
+declare function inferTransportTypeFromConfig(config: MCPServiceConfig, serviceName?: string): MCPServiceConfig;
 /**
  * 验证工具调用参数
  * 对传入的参数进行完整性和格式验证

package/dist/index.js CHANGED Viewed

@@ -5,7 +5,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 var MCPTransportType = /* @__PURE__ */ ((MCPTransportType2) => {
   MCPTransportType2["STDIO"] = "stdio";
   MCPTransportType2["SSE"] = "sse";
-  MCPTransportType2["STREAMABLE_HTTP"] = "streamable-http";
+  MCPTransportType2["HTTP"] = "http";
   return MCPTransportType2;
 })(MCPTransportType || {});
 var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
@@ -71,8 +71,8 @@ function createTransport(config) {
       return createStdioTransport(config);
     case "sse" /* SSE */:
       return createSSETransport(config);
-    case "streamable-http" /* STREAMABLE_HTTP */:
-      return createStreamableHTTPTransport(config);
+    case "http" /* HTTP */:
+      return createHTTPTransport(config);
     default:
       throw new Error(`\u4E0D\u652F\u6301\u7684\u4F20\u8F93\u7C7B\u578B: ${config.type}`);
   }
@@ -99,15 +99,15 @@ function createSSETransport(config) {
   return new SSEClientTransport(url, options);
 }
 __name(createSSETransport, "createSSETransport");
-function createStreamableHTTPTransport(config) {
+function createHTTPTransport(config) {
   if (!config.url) {
-    throw new Error("StreamableHTTP transport \u9700\u8981 URL \u914D\u7F6E");
+    throw new Error("HTTP transport \u9700\u8981 URL \u914D\u7F6E");
   }
   const url = new URL(config.url);
   const options = createStreamableHTTPOptions(config);
   return new StreamableHTTPClientTransport(url, options);
 }
-__name(createStreamableHTTPTransport, "createStreamableHTTPTransport");
+__name(createHTTPTransport, "createHTTPTransport");
 function createSSEOptions(config) {
   const options = {};
   if (config.apiKey) {
@@ -143,9 +143,6 @@ function createStreamableHTTPOptions(config) {
 }
 __name(createStreamableHTTPOptions, "createStreamableHTTPOptions");
 function validateConfig(config) {
-  if (!config.name || typeof config.name !== "string") {
-    throw new Error("\u914D\u7F6E\u5FC5\u987B\u5305\u542B\u6709\u6548\u7684 name \u5B57\u6BB5");
-  }
   if (config.type && !Object.values(MCPTransportType).includes(config.type)) {
     throw new Error(`\u4E0D\u652F\u6301\u7684\u4F20\u8F93\u7C7B\u578B: ${config.type}`);
   }
@@ -163,7 +160,7 @@ function validateConfig(config) {
         throw new Error(`${config.type} \u7C7B\u578B\u9700\u8981 url \u5B57\u6BB5`);
       }
       break;
-    case "streamable-http" /* STREAMABLE_HTTP */:
+    case "http" /* HTTP */:
       if (config.url === void 0 || config.url === null) {
         throw new Error(`${config.type} \u7C7B\u578B\u9700\u8981 url \u5B57\u6BB5`);
       }
@@ -177,7 +174,7 @@ function getSupportedTypes() {
   return [
     "stdio" /* STDIO */,
     "sse" /* SSE */,
-    "streamable-http" /* STREAMABLE_HTTP */
+    "http" /* HTTP */
   ];
 }
 __name(getSupportedTypes, "getSupportedTypes");
@@ -199,30 +196,45 @@ var TypeFieldNormalizer;
       return normalizedConfig;
     }
     const originalType = normalizedConfig.type;
-    if (originalType === "sse" || originalType === "streamable-http") {
+    if (originalType === "stdio" || originalType === "sse" || originalType === "http") {
       return normalizedConfig;
     }
-    let normalizedType;
-    if (originalType === "streamableHttp" || originalType === "streamable_http") {
-      normalizedType = "streamable-http";
-    } else if (originalType === "s_se" || originalType === "s-se") {
-      normalizedType = "sse";
-    } else {
-      normalizedType = convertToKebabCase(originalType);
-    }
-    if (normalizedType === "sse" || normalizedType === "streamable-http") {
+    const normalizedType = normalizeTypeValue(originalType);
+    if (normalizedType === "stdio" || normalizedType === "sse" || normalizedType === "http") {
       normalizedConfig.type = normalizedType;
-      if (originalType !== normalizedType) {
-      }
     }
     return normalizedConfig;
   }
   TypeFieldNormalizer2.normalizeTypeField = normalizeTypeField2;
   __name(normalizeTypeField2, "normalizeTypeField");
-  function convertToKebabCase(str) {
-    return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/_/g, "-").toLowerCase();
+  function normalizeTypeValue(type) {
+    if (type === "http" || type === "streamable-http" || type === "streamable_http" || type === "streamableHttp") {
+      return "http";
+    }
+    if (type === "sse" || type === "s_se" || type === "s-se") {
+      return "sse";
+    }
+    if (type === "stdio") {
+      return "stdio";
+    }
+    return convertToStandardFormat(type);
+  }
+  TypeFieldNormalizer2.normalizeTypeValue = normalizeTypeValue;
+  __name(normalizeTypeValue, "normalizeTypeValue");
+  function convertToStandardFormat(str) {
+    const lowered = str.toLowerCase();
+    if (lowered.includes("http") || lowered.includes("streamable")) {
+      return "http";
+    }
+    if (lowered.includes("sse")) {
+      return "sse";
+    }
+    if (lowered.includes("stdio")) {
+      return "stdio";
+    }
+    return str;
   }
-  __name(convertToKebabCase, "convertToKebabCase");
+  __name(convertToStandardFormat, "convertToStandardFormat");
 })(TypeFieldNormalizer || (TypeFieldNormalizer = {}));
 function normalizeTypeField(config) {
   return TypeFieldNormalizer.normalizeTypeField(config);
@@ -238,19 +250,19 @@ function inferTransportTypeFromUrl(url, options) {
       return "sse" /* SSE */;
     }
     if (pathname.endsWith("/mcp")) {
-      return "streamable-http" /* STREAMABLE_HTTP */;
+      return "http" /* HTTP */;
     }
     if (options?.serviceName) {
     }
-    return "streamable-http" /* STREAMABLE_HTTP */;
+    return "http" /* HTTP */;
   } catch (error) {
     if (options?.serviceName) {
     }
-    return "streamable-http" /* STREAMABLE_HTTP */;
+    return "http" /* HTTP */;
   }
 }
 __name(inferTransportTypeFromUrl, "inferTransportTypeFromUrl");
-function inferTransportTypeFromConfig(config) {
+function inferTransportTypeFromConfig(config, serviceName) {
   if (config.type) {
     const normalizedConfig = TypeFieldNormalizer.normalizeTypeField(config);
     return normalizedConfig;
@@ -263,7 +275,7 @@ function inferTransportTypeFromConfig(config) {
   }
   if (config.url !== void 0 && config.url !== null) {
     const inferredType = inferTransportTypeFromUrl(config.url, {
-      serviceName: config.name
+      serviceName
     });
     return {
       ...config,
@@ -271,7 +283,7 @@ function inferTransportTypeFromConfig(config) {
     };
   }
   throw new Error(
-    `\u65E0\u6CD5\u4E3A\u670D\u52A1 ${config.name} \u63A8\u65AD\u4F20\u8F93\u7C7B\u578B\u3002\u8BF7\u663E\u5F0F\u6307\u5B9A type \u5B57\u6BB5\uFF0C\u6216\u63D0\u4F9B command/url \u914D\u7F6E`
+    `\u65E0\u6CD5\u4E3A\u670D\u52A1 ${serviceName || "\u672A\u77E5"} \u63A8\u65AD\u4F20\u8F93\u7C7B\u578B\u3002\u8BF7\u663E\u5F0F\u6307\u5B9A type \u5B57\u6BB5\uFF0C\u6216\u63D0\u4F9B command/url \u914D\u7F6E`
   );
 }
 __name(inferTransportTypeFromConfig, "inferTransportTypeFromConfig");
@@ -332,6 +344,8 @@ var MCPConnection = class {
   static {
     __name(this, "MCPConnection");
   }
+  name;
+  // 服务名称（独立字段）
   config;
   client = null;
   transport = null;
@@ -340,8 +354,9 @@ var MCPConnection = class {
   connectionTimeout = null;
   initialized = false;
   callbacks;
-  constructor(config, callbacks) {
-    this.config = inferTransportTypeFromConfig(config);
+  constructor(name, config, callbacks) {
+    this.name = name;
+    this.config = inferTransportTypeFromConfig(config, name);
     this.callbacks = callbacks;
     this.validateConfig();
   }
@@ -349,7 +364,14 @@ var MCPConnection = class {
    * 验证配置
    */
   validateConfig() {
-    TransportFactory.validateConfig(this.config);
+    if (!this.name || typeof this.name !== "string") {
+      throw new Error("\u670D\u52A1\u540D\u79F0\u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
+    }
+    const fullConfig = {
+      name: this.name,
+      ...this.config
+    };
+    TransportFactory.validateConfig(fullConfig);
   }
   /**
    * 连接到 MCP 服务
@@ -367,27 +389,32 @@ var MCPConnection = class {
   async attemptConnection() {
     this.connectionState = "connecting" /* CONNECTING */;
     return new Promise((resolve, reject) => {
+      const CONNECTION_TIMEOUT = 3e4;
       this.connectionTimeout = setTimeout(() => {
-        const error = new Error(`\u8FDE\u63A5\u8D85\u65F6 (${this.config.timeout || 1e4}ms)`);
+        const error = new Error(`\u8FDE\u63A5\u8D85\u65F6 (${CONNECTION_TIMEOUT}ms)`);
         this.handleConnectionError(error);
         reject(error);
-      }, this.config.timeout || 1e4);
+      }, CONNECTION_TIMEOUT);
       try {
         this.client = new Client(
           {
-            name: `xiaozhi-${this.config.name}-client`,
+            name: `xiaozhi-${this.name}-client`,
             version: "1.0.0"
           },
           {
             capabilities: {}
           }
         );
-        this.transport = TransportFactory.create(this.config);
+        const fullConfig = {
+          name: this.name,
+          ...this.config
+        };
+        this.transport = TransportFactory.create(fullConfig);
         this.client.connect(this.transport).then(async () => {
           this.handleConnectionSuccess();
           await this.refreshTools();
           this.callbacks?.onConnected?.({
-            serviceName: this.config.name,
+            serviceName: this.name,
             tools: this.getTools(),
             connectionTime: /* @__PURE__ */ new Date()
           });
@@ -425,7 +452,7 @@ var MCPConnection = class {
     }
     this.cleanupConnection();
     this.callbacks?.onConnectionFailed?.({
-      serviceName: this.config.name,
+      serviceName: this.name,
       error,
       attempt: 0
     });
@@ -474,7 +501,7 @@ var MCPConnection = class {
     this.cleanupConnection();
     this.connectionState = "disconnected" /* DISCONNECTED */;
     this.callbacks?.onDisconnected?.({
-      serviceName: this.config.name,
+      serviceName: this.name,
       reason: "\u624B\u52A8\u65AD\u5F00",
       disconnectionTime: /* @__PURE__ */ new Date()
     });
@@ -490,10 +517,10 @@ var MCPConnection = class {
    */
   async callTool(name, arguments_) {
     if (!this.client) {
-      throw new Error(`\u670D\u52A1 ${this.config.name} \u672A\u8FDE\u63A5`);
+      throw new Error(`\u670D\u52A1 ${this.name} \u672A\u8FDE\u63A5`);
     }
     if (!this.tools.has(name)) {
-      throw new Error(`\u5DE5\u5177 ${name} \u5728\u670D\u52A1 ${this.config.name} \u4E2D\u4E0D\u5B58\u5728`);
+      throw new Error(`\u5DE5\u5177 ${name} \u5728\u670D\u52A1 ${this.name} \u4E2D\u4E0D\u5B58\u5728`);
     }
     try {
       const result = await this.client.callTool({
@@ -509,17 +536,20 @@ var MCPConnection = class {
    * 获取服务配置
    */
   getConfig() {
-    return this.config;
+    return {
+      name: this.name,
+      ...this.config
+    };
   }
   /**
    * 获取服务状态
    */
   getStatus() {
     return {
-      name: this.config.name,
+      name: this.name,
       connected: this.connectionState === "connected" /* CONNECTED */,
       initialized: this.initialized,
-      transportType: this.config.type || "streamable-http" /* STREAMABLE_HTTP */,
+      transportType: this.config.type || "http" /* HTTP */,
       toolCount: this.tools.size,
       connectionState: this.connectionState
     };
@@ -571,21 +601,18 @@ var MCPManager = class extends EventEmitter {
     if (this.configs.has(name)) {
       throw new Error(`\u670D\u52A1 ${name} \u5DF2\u5B58\u5728`);
     }
-    const fullConfig = {
-      ...config,
-      name
-    };
+    const normalizedConfig = { ...config };
     if (config.type) {
       const typeStr = String(config.type);
       if (typeStr === "http") {
-        fullConfig.type = "streamable-http" /* STREAMABLE_HTTP */;
+        normalizedConfig.type = "http" /* HTTP */;
       } else if (typeStr === "sse") {
-        fullConfig.type = "sse" /* SSE */;
+        normalizedConfig.type = "sse" /* SSE */;
       } else {
-        fullConfig.type = config.type;
+        normalizedConfig.type = config.type;
       }
     }
-    this.configs.set(name, fullConfig);
+    this.configs.set(name, normalizedConfig);
   }
   /**
    * 移除服务器配置
@@ -608,7 +635,7 @@ var MCPManager = class extends EventEmitter {
     const promises = Array.from(this.configs.entries()).map(
       async ([name, config]) => {
         try {
-          const connection = new MCPConnection(config, {
+          const connection = new MCPConnection(name, config, {
             onConnected: /* @__PURE__ */ __name((data) => {
               this.emit("connected", {
                 serverName: data.serviceName,

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/types.ts","../src/connection.ts","../src/transport-factory.ts","../src/utils/type-normalizer.ts","../src/utils/validators.ts","../src/manager.ts"],"sourcesContent":["/*\n MCP 核心库类型定义\n * 统一管理所有 MCP 相关的类型定义\n /\n\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport type { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\n\n// =========================\n// 1. 基础传输类型\n// =========================\n\n/\n MCP 传输层联合类型定义\n * 支持 STDIO、SSE、StreamableHTTP 三种传输协议\n /\nexport type MCPServerTransport =\n \| StdioClientTransport\n \| SSEClientTransport\n \| StreamableHTTPClientTransport;\n\n/\n 通信方式枚举\n * 定义 MCP 支持的传输类型\n /\nexport enum MCPTransportType {\n STDIO = \"stdio\",\n SSE = \"sse\",\n STREAMABLE_HTTP = \"streamable-http\",\n}\n\n// =========================\n// 1.1 事件回调接口\n// =========================\n\n/\n MCP 服务事件回调接口\n * 用于替代 EventBus 依赖，提供灵活的事件处理机制\n /\nexport interface MCPServiceEventCallbacks {\n /* 连接成功回调 /\n onConnected?: (data: {\n serviceName: string;\n tools: Tool[];\n connectionTime: Date;\n }) => void;\n /* 断开连接回调 /\n onDisconnected?: (data: {\n serviceName: string;\n reason?: string;\n disconnectionTime: Date;\n }) => void;\n /* 连接失败回调 /\n onConnectionFailed?: (data: {\n serviceName: string;\n error: Error;\n attempt: number;\n }) => void;\n}\n\n// =========================\n// 2. 配置接口类型\n// =========================\n\n/\n ModelScope SSE 自定义选项接口\n /\nexport interface ModelScopeSSEOptions {\n eventSourceInit?: {\n fetch?: (\n url: string \| URL \| Request,\n init?: RequestInit\n ) => Promise<Response>;\n };\n requestInit?: RequestInit;\n}\n\n/\n MCP 服务配置接口\n * 包含所有 MCP 服务的配置选项\n /\nexport interface MCPServiceConfig {\n name: string;\n type?: MCPTransportType; // 现在是可选的，支持自动推断\n // stdio 配置\n command?: string;\n args?: string[];\n env?: Record<string, string>; // 环境变量配置\n // 网络配置\n url?: string;\n // 认证配置\n apiKey?: string;\n headers?: Record<string, string>;\n // ModelScope 特有配置\n modelScopeAuth?: boolean;\n customSSEOptions?: ModelScopeSSEOptions;\n // 超时配置\n timeout?: number;\n // 重试配置\n retryAttempts?: number;\n}\n\n// =========================\n// 3. 状态枚举类型\n// =========================\n\n/\n 连接状态枚举\n /\nexport enum ConnectionState {\n DISCONNECTED = \"disconnected\",\n CONNECTING = \"connecting\",\n CONNECTED = \"connected\",\n RECONNECTING = \"reconnecting\",\n FAILED = \"failed\",\n ERROR = \"error\",\n}\n\n/\n MCP 服务状态接口\n /\nexport interface MCPServiceStatus {\n name: string;\n connected: boolean;\n initialized: boolean;\n transportType: MCPTransportType;\n toolCount: number;\n lastError?: string;\n connectionState: ConnectionState;\n}\n\n// =========================\n// 4. 工具调用相关类型\n// =========================\n\n/\n 工具调用结果接口\n /\nexport interface ToolCallResult {\n content: Array<{\n type: string;\n text: string;\n }>;\n isError?: boolean;\n}\n\n/\n JSON Schema 类型定义\n /\nexport type JSONSchema =\n \| (Record<string, unknown> & {\n type: \"object\";\n properties?: Record<string, unknown>;\n required?: string[];\n additionalProperties?: boolean;\n })\n \| Record<string, unknown>;\n\n/\n 类型守卫：检查对象是否为有效的 MCP Tool JSON Schema\n /\nexport function isValidToolJSONSchema(obj: unknown): obj is {\n type: \"object\";\n properties?: Record<string, unknown>;\n required?: string[];\n additionalProperties?: boolean;\n} {\n return (\n typeof obj === \"object\" &&\n obj !== null &&\n \"type\" in obj &&\n (obj as { type?: unknown }).type === \"object\"\n );\n}\n\n/\n 确保对象符合 MCP Tool JSON Schema 格式\n /\nexport function ensureToolJSONSchema(schema: JSONSchema): {\n type: \"object\";\n properties?: Record<string, object>;\n required?: string[];\n additionalProperties?: boolean;\n} {\n if (isValidToolJSONSchema(schema)) {\n return schema as {\n type: \"object\";\n properties?: Record<string, object>;\n required?: string[];\n additionalProperties?: boolean;\n };\n }\n\n return {\n type: \"object\",\n properties: {} as Record<string, object>,\n required: [],\n additionalProperties: true,\n };\n}\n\n/\n CustomMCP 工具类型定义\n /\nexport interface CustomMCPTool {\n name: string;\n description?: string;\n inputSchema: JSONSchema;\n handler?: {\n type: string;\n config?: Record<string, unknown>;\n };\n}\n\n/\n 工具信息接口\n /\nexport interface ToolInfo {\n serviceName: string;\n originalName: string;\n tool: Tool;\n}\n\n// =========================\n// 5. 增强工具信息类型\n// =========================\n\n/\n 工具状态过滤选项\n /\nexport type ToolStatusFilter = \"enabled\" \| \"disabled\" \| \"all\";\n\n/\n 增强的工具信息接口\n /\nexport interface EnhancedToolInfo {\n /* 工具唯一标识符，格式为 \"{serviceName}__{originalName}\" /\n name: string;\n /* 工具描述信息 /\n description: string;\n /* 工具输入参数的 JSON Schema 定义 /\n inputSchema: JSONSchema;\n /* 工具所属的 MCP 服务名称 /\n serviceName: string;\n /* 工具在 MCP 服务中的原始名称 /\n originalName: string;\n /* 工具是否启用 /\n enabled: boolean;\n /* 工具使用次数统计 /\n usageCount: number;\n /* 工具最后使用时间 /\n lastUsedTime: string;\n}\n\n// =========================\n// 6. 服务器配置类型\n// =========================\n\n/\n 统一服务器配置接口\n /\nexport interface UnifiedServerConfig {\n name?: string;\n enableLogging?: boolean;\n logLevel?: string;\n configs?: Record<string, MCPServiceConfig>;\n}\n\n/\n 统一服务器状态接口\n /\nexport interface UnifiedServerStatus {\n isRunning: boolean;\n serviceStatus: ManagerStatus;\n transportCount: number;\n activeConnections: number;\n config: UnifiedServerConfig;\n services?: Record<string, MCPServiceConnectionStatus>;\n totalTools?: number;\n availableTools?: string[];\n}\n\n// =========================\n// 7. 管理器相关类型\n// =========================\n\n/\n MCP 服务连接状态接口\n /\nexport interface MCPServiceConnectionStatus {\n connected: boolean;\n clientName: string;\n}\n\n/\n 管理器状态接口\n /\nexport interface ManagerStatus {\n services: Record<string, MCPServiceConnectionStatus>;\n totalTools: number;\n availableTools: string[];\n}\n\n// =========================\n// 8. 参数校验相关类型\n// =========================\n\n/\n 工具调用参数接口\n /\nexport interface ToolCallParams {\n name: string;\n arguments?: Record<string, unknown>;\n}\n\n/\n 验证后的工具调用参数\n /\nexport interface ValidatedToolCallParams {\n name: string;\n arguments?: Record<string, unknown>;\n}\n\n/\n 工具调用验证选项\n /\nexport interface ToolCallValidationOptions {\n validateName?: boolean;\n validateArguments?: boolean;\n allowEmptyArguments?: boolean;\n customValidator?: (params: ToolCallParams) => string \| null;\n}\n\n/\n 工具调用错误码枚举\n /\nexport enum ToolCallErrorCode {\n INVALID_PARAMS = -32602,\n TOOL_NOT_FOUND = -32601,\n SERVICE_UNAVAILABLE = -32001,\n TIMEOUT = -32002,\n TOOL_EXECUTION_ERROR = -32000,\n}\n\n/\n 工具调用错误类\n /\nexport class ToolCallError extends Error {\n constructor(\n public code: ToolCallErrorCode,\n message: string,\n public data?: unknown\n ) {\n super(message);\n this.name = \"ToolCallError\";\n }\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { MCPServerTransport, MCPServiceConfig, MCPServiceStatus, ToolCallResult } from \"./types.js\";\nimport { ConnectionState, MCPTransportType } from \"./types.js\";\nimport { TransportFactory } from \"./transport-factory.js\";\nimport { inferTransportTypeFromConfig } from \"./utils/index.js\";\n\n/\n MCP 连接类\n * 负责管理单个 MCP 服务的连接、工具管理和调用\n /\nexport class MCPConnection {\n private config: MCPServiceConfig;\n private client: Client \| null = null;\n private transport: MCPServerTransport \| null = null;\n private tools: Map<string, Tool> = new Map();\n private connectionState: ConnectionState = ConnectionState.DISCONNECTED;\n private connectionTimeout: NodeJS.Timeout \| null = null;\n private initialized = false;\n private callbacks?: import(\"./types.js\").MCPServiceEventCallbacks;\n\n constructor(\n config: MCPServiceConfig,\n callbacks?: import(\"./types.js\").MCPServiceEventCallbacks\n ) {\n // 使用工具方法推断服务类型\n this.config = inferTransportTypeFromConfig(config);\n this.callbacks = callbacks;\n\n // 验证配置\n this.validateConfig();\n }\n\n /\n 验证配置\n /\n private validateConfig(): void {\n // 使用 TransportFactory 进行配置验证\n TransportFactory.validateConfig(this.config);\n }\n\n /\n 连接到 MCP 服务\n /\n async connect(): Promise<void> {\n // 如果正在连接中，等待当前连接完成\n if (this.connectionState === ConnectionState.CONNECTING) {\n throw new Error(\"连接正在进行中，请等待连接完成\");\n }\n\n // 清理之前的连接\n this.cleanupConnection();\n\n return this.attemptConnection();\n }\n\n /\n 尝试建立连接\n /\n private async attemptConnection(): Promise<void> {\n this.connectionState = ConnectionState.CONNECTING;\n console.debug(\n `[MCP-${this.config.name}] 正在连接 MCP 服务: ${this.config.name}`\n );\n\n return new Promise((resolve, reject) => {\n // 设置连接超时\n this.connectionTimeout = setTimeout(() => {\n const error = new Error(`连接超时 (${this.config.timeout \|\| 10000}ms)`);\n this.handleConnectionError(error);\n reject(error);\n }, this.config.timeout \|\| 10000);\n\n try {\n this.client = new Client(\n {\n name: `xiaozhi-${this.config.name}-client`,\n version: \"1.0.0\",\n },\n {\n capabilities: {},\n }\n );\n\n // 使用 TransportFactory 创建传输层\n this.transport = TransportFactory.create(this.config);\n\n // 连接到 MCP 服务\n this.client\n .connect(this.transport as MCPServerTransport)\n .then(async () => {\n this.handleConnectionSuccess();\n\n // 获取工具列表\n await this.refreshTools();\n\n // 发射连接成功事件\n this.callbacks?.onConnected?.({\n serviceName: this.config.name,\n tools: this.getTools(),\n connectionTime: new Date(),\n });\n\n resolve();\n })\n .catch((error) => {\n this.handleConnectionError(error);\n reject(error);\n });\n } catch (error) {\n this.handleConnectionError(error as Error);\n reject(error);\n }\n });\n }\n\n /\n 处理连接成功\n /\n private handleConnectionSuccess(): void {\n // 清理连接超时定时器\n if (this.connectionTimeout) {\n clearTimeout(this.connectionTimeout);\n this.connectionTimeout = null;\n }\n\n this.connectionState = ConnectionState.CONNECTED;\n this.initialized = true;\n\n console.info(\n `[MCP-${this.config.name}] MCP 服务 ${this.config.name} 连接已建立`\n );\n }\n\n /\n 处理连接错误\n /\n private handleConnectionError(error: Error): void {\n this.connectionState = ConnectionState.DISCONNECTED;\n this.initialized = false;\n\n console.debug(`MCP 服务 ${this.config.name} 连接错误:`, error.message);\n\n // 清理连接超时定时器\n if (this.connectionTimeout) {\n clearTimeout(this.connectionTimeout);\n this.connectionTimeout = null;\n }\n\n // 清理当前连接\n this.cleanupConnection();\n\n // 发射连接失败事件\n this.callbacks?.onConnectionFailed?.({\n serviceName: this.config.name,\n error,\n attempt: 0,\n });\n }\n\n /\n 清理连接资源\n /\n private cleanupConnection(): void {\n // 清理客户端\n if (this.client) {\n try {\n this.client.close().catch(() => {\n // 忽略关闭时的错误\n });\n } catch (error) {\n // 忽略关闭时的错误\n }\n this.client = null;\n }\n\n // 清理传输层\n this.transport = null;\n\n // 清理连接超时定时器\n if (this.connectionTimeout) {\n clearTimeout(this.connectionTimeout);\n this.connectionTimeout = null;\n }\n\n // 重置状态\n this.initialized = false;\n }\n\n /\n 刷新工具列表\n /\n private async refreshTools(): Promise<void> {\n if (!this.client) {\n throw new Error(\"客户端未初始化\");\n }\n\n try {\n const toolsResult = await this.client.listTools();\n const tools: Tool[] = toolsResult.tools \|\| [];\n\n // 清空现有工具\n this.tools.clear();\n\n // 注册工具到映射表\n for (const tool of tools) {\n this.tools.set(tool.name, tool);\n }\n\n console.debug(\n `${this.config.name} 服务加载了 ${tools.length} 个工具: ${tools\n .map((t) => t.name)\n .join(\", \")}`\n );\n } catch (error) {\n console.error(\n `${this.config.name} 获取工具列表失败:`,\n error instanceof Error ? error.message : String(error)\n );\n throw error;\n }\n }\n\n /\n 断开连接\n /\n async disconnect(): Promise<void> {\n console.info(`主动断开 MCP 服务 ${this.config.name} 连接`);\n\n // 清理连接资源\n this.cleanupConnection();\n\n // 设置状态为已断开\n this.connectionState = ConnectionState.DISCONNECTED;\n\n // 发射断开连接事件\n this.callbacks?.onDisconnected?.({\n serviceName: this.config.name,\n reason: \"手动断开\",\n disconnectionTime: new Date(),\n });\n }\n\n /\n 获取工具列表\n /\n getTools(): Tool[] {\n return Array.from(this.tools.values());\n }\n\n /\n 调用工具\n /\n async callTool(\n name: string,\n arguments_: Record<string, unknown>\n ): Promise<ToolCallResult> {\n if (!this.client) {\n throw new Error(`服务 ${this.config.name} 未连接`);\n }\n\n if (!this.tools.has(name)) {\n throw new Error(`工具 ${name} 在服务 ${this.config.name} 中不存在`);\n }\n\n console.debug(\n `调用 ${this.config.name} 服务的工具 ${name}，参数:`,\n JSON.stringify(arguments_)\n );\n\n try {\n const result = await this.client.callTool({\n name,\n arguments: arguments_ \|\| {},\n });\n\n console.debug(\n `工具 ${name} 调用成功，结果:`,\n `${JSON.stringify(result).substring(0, 500)}...`\n );\n\n return result as ToolCallResult;\n } catch (error) {\n console.error(\n `工具 ${name} 调用失败:`,\n error instanceof Error ? error.message : String(error)\n );\n throw error;\n }\n }\n\n /\n 获取服务配置\n /\n getConfig(): MCPServiceConfig {\n return this.config;\n }\n\n /\n 获取服务状态\n /\n getStatus(): MCPServiceStatus {\n return {\n name: this.config.name,\n connected: this.connectionState === ConnectionState.CONNECTED,\n initialized: this.initialized,\n transportType: this.config.type \|\| MCPTransportType.STREAMABLE_HTTP,\n toolCount: this.tools.size,\n connectionState: this.connectionState,\n };\n }\n\n /\n 检查是否已连接\n /\n isConnected(): boolean {\n return (\n this.connectionState === ConnectionState.CONNECTED && this.initialized\n );\n }\n}\n","import type { MCPServerTransport, MCPServiceConfig } from \"./types.js\";\nimport { MCPTransportType } from \"./types.js\";\nimport type { SSEClientTransportOptions } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { StreamableHTTPClientTransportOptions } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { EventSource } from \"eventsource\";\n\n// 全局 polyfill EventSource（用于 SSE）\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst globalThisAny: any = typeof globalThis !== \"undefined\" ? globalThis : global;\nif (\n typeof globalThisAny !== \"undefined\" &&\n !globalThisAny.EventSource\n) {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n globalThisAny.EventSource = EventSource;\n}\n\n// Transport 基础接口\nexport interface Transport {\n connect?(): Promise<void>;\n close?(): Promise<void>;\n}\n\n/\n 创建 transport 实例\n * @param config MCP 服务配置\n * @returns transport 实例\n /\nexport function createTransport(config: MCPServiceConfig): MCPServerTransport {\n console.debug(\n `[TransportFactory] 创建 ${config.type} transport for ${config.name}`\n );\n\n switch (config.type) {\n case MCPTransportType.STDIO:\n return createStdioTransport(config);\n\n case MCPTransportType.SSE:\n return createSSETransport(config);\n\n case MCPTransportType.STREAMABLE_HTTP:\n return createStreamableHTTPTransport(config);\n\n default:\n throw new Error(`不支持的传输类型: ${config.type}`);\n }\n}\n\n/\n 创建 Stdio transport\n /\nfunction createStdioTransport(config: MCPServiceConfig): StdioClientTransport {\n if (!config.command) {\n throw new Error(\"stdio transport 需要 command 配置\");\n }\n\n return new StdioClientTransport({\n command: config.command,\n args: config.args \|\| [],\n env: config.env, // 传递环境变量\n });\n}\n\n/\n 创建 SSE transport\n /\nfunction createSSETransport(config: MCPServiceConfig): SSEClientTransport {\n if (!config.url) {\n throw new Error(\"SSE transport 需要 URL 配置\");\n }\n\n const url = new URL(config.url);\n const options = createSSEOptions(config);\n\n return new SSEClientTransport(url, options);\n}\n\nfunction createStreamableHTTPTransport(\n config: MCPServiceConfig\n): StreamableHTTPClientTransport {\n if (!config.url) {\n throw new Error(\"StreamableHTTP transport 需要 URL 配置\");\n }\n\n const url = new URL(config.url);\n const options = createStreamableHTTPOptions(config);\n return new StreamableHTTPClientTransport(url, options);\n}\n\n/\n 创建 SSE 选项\n /\nfunction createSSEOptions(config: MCPServiceConfig): SSEClientTransportOptions {\n const options: SSEClientTransportOptions = {};\n\n // 添加认证头\n if (config.apiKey) {\n options.requestInit = {\n headers: {\n Authorization: `Bearer ${config.apiKey}`,\n ...config.headers,\n },\n };\n } else if (config.headers) {\n options.requestInit = {\n headers: config.headers,\n };\n }\n\n return options;\n}\n\nfunction createStreamableHTTPOptions(\n config: MCPServiceConfig\n): StreamableHTTPClientTransportOptions {\n const options: StreamableHTTPClientTransportOptions = {};\n\n // 添加认证头\n if (config.apiKey) {\n options.requestInit = {\n headers: {\n Authorization: `Bearer ${config.apiKey}`,\n ...config.headers,\n },\n };\n } else if (config.headers) {\n options.requestInit = {\n headers: config.headers,\n };\n }\n\n return options;\n}\n\n/\n 验证配置\n /\nexport function validateConfig(config: MCPServiceConfig): void {\n if (!config.name \|\| typeof config.name !== \"string\") {\n throw new Error(\"配置必须包含有效的 name 字段\");\n }\n\n // type 字段现在是可选的，由 MCPService 自动推断\n // 这里我们只验证如果 type 存在，必须是有效的类型\n if (config.type && !Object.values(MCPTransportType).includes(config.type)) {\n throw new Error(`不支持的传输类型: ${config.type}`);\n }\n\n // 注意：这个验证方法在 MCPService.inferTransportType 之后调用\n // 此时 config.type 应该已经被推断或显式设置\n if (!config.type) {\n throw new Error(\"传输类型未设置，这应该在 inferTransportType 中处理\");\n }\n\n switch (config.type) {\n case MCPTransportType.STDIO:\n if (!config.command) {\n throw new Error(\"stdio 类型需要 command 字段\");\n }\n break;\n\n case MCPTransportType.SSE:\n if (config.url === undefined \|\| config.url === null) {\n throw new Error(`${config.type} 类型需要 url 字段`);\n }\n break;\n case MCPTransportType.STREAMABLE_HTTP:\n // STREAMABLE_HTTP 允许空 URL，会在后续处理中设置默认值\n if (config.url === undefined \|\| config.url === null) {\n throw new Error(`${config.type} 类型需要 url 字段`);\n }\n break;\n\n default:\n throw new Error(`不支持的传输类型: ${config.type}`);\n }\n}\n\n/\n 获取支持的传输类型列表\n /\nexport function getSupportedTypes(): MCPTransportType[] {\n return [\n MCPTransportType.STDIO,\n MCPTransportType.SSE,\n MCPTransportType.STREAMABLE_HTTP,\n ];\n}\n\n/\n Transport 工厂对象（保持 API 兼容性）\n /\nexport const TransportFactory = {\n create: createTransport,\n validateConfig,\n getSupportedTypes,\n};\n","/\n MCP 服务器配置 Type 字段标准化工具\n * 支持将各种 type 字段格式转换为标准的中划线格式\n /\n\n/\n MCP 服务器配置的基础接口\n * 定义包含可选 type 字段的配置对象结构\n /\nexport interface MCPBaseConfig {\n type?: string;\n [key: string]: unknown; // 允许其他配置属性\n}\n\n/\n MCP 服务器配置 Type 字段标准化工具类\n /\nexport namespace TypeFieldNormalizer {\n /\n 标准化type字段格式\n * 支持将各种格式转换为标准的中划线格式\n /\n // 函数重载：泛型版本，用于类型安全的调用\n export function normalizeTypeField<T extends MCPBaseConfig>(config: T): T;\n\n // 函数重载：向后兼容版本，用于 unknown 类型输入\n export function normalizeTypeField(config: unknown): unknown;\n\n // 统一实现\n export function normalizeTypeField<T extends MCPBaseConfig>(\n config: T \| unknown\n ): T \| unknown {\n if (!config \|\| typeof config !== \"object\") {\n return config;\n }\n\n // 创建配置的深拷贝以避免修改原始对象\n const normalizedConfig = JSON.parse(JSON.stringify(config));\n\n // 如果配置中没有type字段，直接返回\n if (!(\"type\" in normalizedConfig)) {\n return normalizedConfig;\n }\n\n const originalType = normalizedConfig.type;\n\n // 如果已经是标准格式，直接返回\n if (originalType === \"sse\" \|\| originalType === \"streamable-http\") {\n return normalizedConfig;\n }\n\n // 转换为标准格式\n let normalizedType: string;\n\n if (\n originalType === \"streamableHttp\" \|\|\n originalType === \"streamable_http\"\n ) {\n normalizedType = \"streamable-http\";\n } else if (originalType === \"s_se\" \|\| originalType === \"s-se\") {\n normalizedType = \"sse\";\n } else {\n // 对于其他格式，尝试智能转换\n normalizedType = convertToKebabCase(originalType);\n }\n\n // 验证转换后的类型是否有效\n if (normalizedType === \"sse\" \|\| normalizedType === \"streamable-http\") {\n normalizedConfig.type = normalizedType;\n // 记录转换日志（如果有的话）\n if (originalType !== normalizedType) {\n // 可以在需要时添加日志记录\n }\n }\n\n return normalizedConfig;\n }\n\n /\n 将字符串转换为kebab-case格式\n /\n function convertToKebabCase(str: string): string {\n return str\n .replace(/([a-z])([A-Z])/g, \"$1-$2\") // 驼峰转中划线\n .replace(/_/g, \"-\") // 下划线转中划线\n .toLowerCase(); // 转小写\n }\n}\n\n/\n 导出便捷函数\n /\nexport function normalizeTypeField<T extends MCPBaseConfig>(\n config: T\n): T;\nexport function normalizeTypeField(config: unknown): unknown;\nexport function normalizeTypeField<T extends MCPBaseConfig>(\n config: T \| unknown\n): T \| unknown {\n return TypeFieldNormalizer.normalizeTypeField(config);\n}\n","import { MCPTransportType, ToolCallError, ToolCallErrorCode } from \"../types.js\";\nimport { TypeFieldNormalizer } from \"./type-normalizer.js\";\nimport type {\n MCPServiceConfig,\n ToolCallParams,\n ToolCallValidationOptions,\n ValidatedToolCallParams,\n} from \"../types.js\";\n\n/\n 根据 URL 路径推断传输类型\n * 基于路径末尾推断，支持包含多个 / 的复杂路径\n \n @param url - 要推断的 URL\n * @param options - 可选配置项\n * @returns 推断出的传输类型\n /\nexport function inferTransportTypeFromUrl(\n url: string,\n options?: {\n serviceName?: string;\n }\n): MCPTransportType {\n try {\n const parsedUrl = new URL(url);\n const pathname = parsedUrl.pathname;\n\n // 检查路径末尾\n if (pathname.endsWith(\"/sse\")) {\n return MCPTransportType.SSE;\n }\n if (pathname.endsWith(\"/mcp\")) {\n return MCPTransportType.STREAMABLE_HTTP;\n }\n\n // 默认类型 - 使用 console 输出\n if (options?.serviceName) {\n console.info(\n `[MCP-${options.serviceName}] URL 路径 ${pathname} 不匹配特定规则，默认推断为 streamable-http 类型`\n );\n }\n return MCPTransportType.STREAMABLE_HTTP;\n } catch (error) {\n if (options?.serviceName) {\n console.warn(\n `[MCP-${options.serviceName}] URL 解析失败，默认推断为 streamable-http 类型`,\n error\n );\n }\n return MCPTransportType.STREAMABLE_HTTP;\n }\n}\n\n/\n 完整的配置类型推断（包括 command 字段）\n \n @param config - MCP 服务配置\n * @returns 完整的配置对象，包含推断出的类型\n /\nexport function inferTransportTypeFromConfig(\n config: MCPServiceConfig\n): MCPServiceConfig {\n // 如果已显式指定类型，先标准化然后返回\n if (config.type) {\n const normalizedConfig = TypeFieldNormalizer.normalizeTypeField(config);\n return normalizedConfig as MCPServiceConfig;\n }\n\n // 基于 command 字段推断\n if (config.command) {\n return {\n ...config,\n type: MCPTransportType.STDIO,\n };\n }\n\n // 基于 URL 字段推断（排除 null 和 undefined）\n if (config.url !== undefined && config.url !== null) {\n const inferredType = inferTransportTypeFromUrl(config.url, {\n serviceName: config.name,\n });\n return {\n ...config,\n type: inferredType,\n };\n }\n\n throw new Error(\n `无法为服务 ${config.name} 推断传输类型。请显式指定 type 字段，或提供 command/url 配置`\n );\n}\n\n// =========================\n// 参数校验工具函数\n// =========================\n\n/\n 验证工具调用参数\n * 对传入的参数进行完整性和格式验证\n \n @param params 待验证的参数\n * @param options 验证选项\n * @returns 验证后的参数\n * @throws ToolCallError 验证失败时抛出\n /\nexport function validateToolCallParams(\n params: unknown,\n options?: ToolCallValidationOptions\n): ValidatedToolCallParams {\n const opts = {\n validateName: true,\n validateArguments: true,\n allowEmptyArguments: true,\n ...options,\n };\n\n // 1. 验证参数必须是对象\n if (!params \|\| typeof params !== \"object\") {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"请求参数必须是对象\"\n );\n }\n\n const paramsObj = params as Record<string, unknown>;\n\n // 2. 验证工具名称\n if (opts.validateName) {\n if (!paramsObj.name \|\| typeof paramsObj.name !== \"string\") {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"工具名称必须是非空字符串\"\n );\n }\n }\n\n // 3. 验证工具参数格式\n if (\n opts.validateArguments &&\n paramsObj.arguments !== undefined &&\n paramsObj.arguments !== null\n ) {\n if (\n typeof paramsObj.arguments !== \"object\" \|\|\n Array.isArray(paramsObj.arguments)\n ) {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"工具参数必须是对象\"\n );\n }\n }\n\n // 4. 验证是否允许空参数\n if (\n !opts.allowEmptyArguments &&\n paramsObj.arguments !== undefined &&\n paramsObj.arguments !== null\n ) {\n const argsObj = paramsObj.arguments as Record<string, unknown>;\n if (Object.keys(argsObj).length === 0) {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"工具参数不能为空\"\n );\n }\n }\n\n // 5. 执行自定义验证\n if (opts.customValidator) {\n const error = opts.customValidator(paramsObj as unknown as ToolCallParams);\n if (error) {\n throw new ToolCallError(ToolCallErrorCode.INVALID_PARAMS, error);\n }\n }\n\n return {\n name: paramsObj.name as string,\n arguments: paramsObj.arguments as Record<string, unknown>,\n };\n}\n","/\n MCP 服务管理器\n * 提供简洁的 API 来管理多个 MCP 服务\n /\n\nimport { EventEmitter } from \"node:events\";\nimport { MCPConnection } from \"./connection.js\";\nimport type { MCPServiceConfig, ToolCallResult } from \"./types.js\";\nimport { MCPTransportType } from \"./types.js\";\n\n/\n 用户友好的传输类型\n * 用于简化和标准化用户输入\n /\ntype UserFriendlyTransportType =\n \| \"stdio\"\n \| \"sse\"\n \| \"http\"\n \| MCPTransportType;\n\n/\n MCP 服务管理器\n * 提供简洁的 API 来管理多个 MCP 服务\n \n @example\n * ```typescript\n * const manager = new MCPManager();\n \n // 添加服务\n * manager.addServer('datetime', {\n * type: 'stdio',\n * command: 'node',\n * args: ['datetime.js']\n * });\n \n // 连接所有服务\n * await manager.connect();\n \n // 调用工具\n * const result = await manager.callTool('datetime', 'get_current_time', {\n * format: 'YYYY-MM-DD HH:mm:ss'\n * });\n \n // 断开连接\n * await manager.disconnect();\n * ```\n /\nexport class MCPManager extends EventEmitter {\n private connections: Map<string, MCPConnection> = new Map();\n private configs: Map<string, MCPServiceConfig> = new Map();\n\n constructor() {\n super();\n }\n\n /\n 添加 MCP 服务器配置\n * @param name 服务器名称\n * @param config 服务器配置\n \n @example\n * ```typescript\n * // 添加 stdio 服务\n * manager.addServer('calculator', {\n * type: 'stdio',\n * command: 'node',\n * args: ['calculator.js']\n * });\n \n // 添加 HTTP 服务\n * manager.addServer('web-search', {\n * type: 'http',\n * url: 'https://api.example.com/mcp',\n * headers: {\n * Authorization: 'Bearer your-api-key'\n * }\n * });\n * ```\n /\n addServer(\n name: string,\n config: Omit<MCPServiceConfig, \"name\"> & {\n type?: UserFriendlyTransportType;\n }\n ): void {\n if (this.configs.has(name)) {\n throw new Error(`服务 ${name} 已存在`);\n }\n\n const fullConfig: MCPServiceConfig = {\n ...config,\n name,\n };\n\n // 标准化 type 字段 - 将用户友好的类型映射到实际的枚举值\n if (config.type) {\n // 首先检查用户友好的字符串类型\n const typeStr = String(config.type);\n if (typeStr === \"http\") {\n fullConfig.type = MCPTransportType.STREAMABLE_HTTP;\n } else if (typeStr === \"sse\") {\n fullConfig.type = MCPTransportType.SSE;\n } else {\n // 已经是枚举值或正确格式\n fullConfig.type = config.type as MCPTransportType;\n }\n }\n\n this.configs.set(name, fullConfig);\n }\n\n /\n 移除服务器配置\n * @param name 服务器名称\n /\n removeServer(name: string): boolean {\n return this.configs.delete(name);\n }\n\n /\n 连接所有已添加的 MCP 服务\n * 所有服务并行连接，单个服务失败不会影响其他服务\n \n @example\n * ```typescript\n * await manager.connect();\n * ```\n /\n async connect(): Promise<void> {\n this.emit(\"connect\");\n\n const promises = Array.from(this.configs.entries()).map(\n async ([name, config]) => {\n try {\n const connection = new MCPConnection(config, {\n onConnected: (data) => {\n this.emit(\"connected\", {\n serverName: data.serviceName,\n tools: data.tools,\n });\n },\n onDisconnected: (data) => {\n this.emit(\"disconnected\", {\n serverName: data.serviceName,\n reason: data.reason,\n });\n },\n onConnectionFailed: (data) => {\n this.emit(\"error\", {\n serverName: data.serviceName,\n error: data.error,\n });\n },\n });\n\n await connection.connect();\n this.connections.set(name, connection);\n } catch (error) {\n this.emit(\"error\", { serverName: name, error });\n throw error;\n }\n }\n );\n\n await Promise.allSettled(promises);\n }\n\n /\n 断开所有 MCP 服务连接\n \n @example\n * ```typescript\n * await manager.disconnect();\n * ```\n /\n async disconnect(): Promise<void> {\n const promises = Array.from(this.connections.values()).map((conn) =>\n conn.disconnect()\n );\n\n await Promise.allSettled(promises);\n this.connections.clear();\n\n this.emit(\"disconnect\");\n }\n\n /\n 调用指定服务的工具\n * @param serverName 服务名称\n * @param toolName 工具名称\n * @param args 工具参数\n \n @example\n * ```typescript\n * const result = await manager.callTool('datetime', 'get_current_time', {\n * format: 'YYYY-MM-DD HH:mm:ss'\n * });\n * ```\n /\n async callTool(\n serverName: string,\n toolName: string,\n args: Record<string, unknown>\n ): Promise<ToolCallResult> {\n const connection = this.connections.get(serverName);\n if (!connection) {\n throw new Error(`服务 ${serverName} 不存在`);\n }\n\n if (!connection.isConnected()) {\n throw new Error(`服务 ${serverName} 未连接`);\n }\n\n return connection.callTool(toolName, args);\n }\n\n /\n 列出所有可用的工具\n * @returns 工具列表，格式为 [{ name, serverName, description, inputSchema }]\n \n @example\n * ```typescript\n * const tools = manager.listTools();\n * console.log('可用工具:', tools.map(t => `${t.serverName}/${t.name}`));\n * ```\n /\n listTools(): Array<{\n name: string;\n serverName: string;\n description: string;\n inputSchema: unknown;\n }> {\n const allTools: Array<{\n name: string;\n serverName: string;\n description: string;\n inputSchema: unknown;\n }> = [];\n\n for (const [serverName, connection] of this.connections) {\n if (connection.isConnected()) {\n const tools = connection.getTools();\n for (const tool of tools) {\n allTools.push({\n name: tool.name,\n serverName,\n description: tool.description \|\| \"\",\n inputSchema: tool.inputSchema,\n });\n }\n }\n }\n\n return allTools;\n }\n\n /\n 获取服务状态\n * @param serverName 服务名称\n * @returns 服务状态，如果服务不存在则返回 null\n \n @example\n * ```typescript\n * const status = manager.getServerStatus('datetime');\n * if (status) {\n * console.log(`已连接: ${status.connected}, 工具数: ${status.toolCount}`);\n * }\n * ```\n /\n getServerStatus(serverName: string): {\n connected: boolean;\n toolCount: number;\n } \| null {\n const connection = this.connections.get(serverName);\n if (!connection) {\n return null;\n }\n\n const status = connection.getStatus();\n return {\n connected: status.connected,\n toolCount: status.toolCount,\n };\n }\n\n /\n 获取所有服务的状态\n * @returns 所有服务的状态映射\n \n @example\n * ```typescript\n * const statuses = manager.getAllServerStatus();\n * console.log(statuses);\n * // {\n * // datetime: { connected: true, toolCount: 3 },\n * // calculator: { connected: true, toolCount: 1 }\n * // }\n * ```\n /\n getAllServerStatus(): Record<\n string,\n { connected: boolean; toolCount: number }\n > {\n const statuses: Record<string, { connected: boolean; toolCount: number }> = {};\n\n for (const [serverName, connection] of this.connections) {\n const status = connection.getStatus();\n statuses[serverName] = {\n connected: status.connected,\n toolCount: status.toolCount,\n };\n }\n\n return statuses;\n }\n\n /\n 检查服务是否已连接\n * @param serverName 服务名称\n \n @example\n * ```typescript\n * if (manager.isConnected('datetime')) {\n * console.log('datetime 服务已连接');\n * }\n * ```\n /\n isConnected(serverName: string): boolean {\n const connection = this.connections.get(serverName);\n return connection ? connection.isConnected() : false;\n }\n\n /\n 获取已配置的服务列表\n * @returns 服务名称数组\n \n @example\n * ```typescript\n * const servers = manager.getServerNames();\n * console.log('已配置的服务:', servers);\n * ```\n /\n getServerNames(): string[] {\n return Array.from(this.configs.keys());\n }\n\n /\n 获取已连接的服务列表\n * @returns 已连接的服务名称数组\n \n @example\n * ```typescript\n * const connectedServers = manager.getConnectedServerNames();\n * console.log('已连接的服务:', connectedServers);\n * ```\n */\n getConnectedServerNames(): string[] {\n const connected: string[] = [];\n for (const [serverName, connection] of this.connections) {\n if (connection.isConnected()) {\n connected.push(serverName);\n }\n }\n return connected;\n }\n}\n\n// 为了向后兼容，保留旧的 MCPServiceManager 类名作为别名\nexport { MCPManager as MCPServiceManager };\n"],"mappings":"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","names":["MCPTransportType","ConnectionState","ToolCallErrorCode","TypeFieldNormalizer","normalizeTypeField"]}
1	+ {"version":3,"sources":["../src/types.ts","../src/connection.ts","../src/transport-factory.ts","../src/utils/type-normalizer.ts","../src/utils/validators.ts","../src/manager.ts"],"sourcesContent":["/*\n MCP 核心库类型定义\n * 统一管理所有 MCP 相关的类型定义\n /\n\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport type { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\n\n// =========================\n// 1. 基础传输类型\n// =========================\n\n/\n MCP 传输层联合类型定义\n * 支持 STDIO、SSE、StreamableHTTP 三种传输协议\n /\nexport type MCPServerTransport =\n \| StdioClientTransport\n \| SSEClientTransport\n \| StreamableHTTPClientTransport;\n\n/\n 通信方式枚举\n * 定义 MCP 支持的传输类型\n /\nexport enum MCPTransportType {\n STDIO = \"stdio\",\n SSE = \"sse\",\n HTTP = \"http\",\n}\n\n/\n 传输类型字符串字面量\n * 方便外部用户直接使用字符串而不需要导入枚举\n /\nexport type MCPTransportTypeString = \"stdio\" \| \"sse\" \| \"http\";\n\n/\n 传输类型输入值（枚举或字符串字面量）\n /\nexport type MCPTransportTypeInput = MCPTransportType \| MCPTransportTypeString;\n\n// =========================\n// 1.1 事件回调接口\n// =========================\n\n/\n MCP 服务事件回调接口\n * 用于替代 EventBus 依赖，提供灵活的事件处理机制\n /\nexport interface MCPServiceEventCallbacks {\n /* 连接成功回调 /\n onConnected?: (data: {\n serviceName: string;\n tools: Tool[];\n connectionTime: Date;\n }) => void;\n /* 断开连接回调 /\n onDisconnected?: (data: {\n serviceName: string;\n reason?: string;\n disconnectionTime: Date;\n }) => void;\n /* 连接失败回调 /\n onConnectionFailed?: (data: {\n serviceName: string;\n error: Error;\n attempt: number;\n }) => void;\n}\n\n// =========================\n// 2. 配置接口类型\n// =========================\n\n/\n ModelScope SSE 自定义选项接口\n /\nexport interface ModelScopeSSEOptions {\n eventSourceInit?: {\n fetch?: (\n url: string \| URL \| Request,\n init?: RequestInit\n ) => Promise<Response>;\n };\n requestInit?: RequestInit;\n}\n\n/\n MCP 服务配置接口\n * 包含所有 MCP 服务的配置选项（不包含服务名称）\n \n @description\n * 与 MCP 官方配置格式保持一致，支持三种传输类型：\n * - stdio: 本地进程通信 { command, args, env }\n * - sse: Server-Sent Events { url, headers }\n * - http: Streamable HTTP { url, headers }\n \n 向后兼容：自动将 streamable-http/streamable_http/streamableHttp 转换为 http\n /\nexport interface MCPServiceConfig {\n // name 字段已从配置中移除，应作为独立参数传递\n type?: MCPTransportTypeInput; // 支持枚举或字符串字面量，如 \"stdio\" \| \"sse\" \| \"http\"\n // stdio 配置\n command?: string;\n args?: string[];\n env?: Record<string, string>; // 环境变量配置\n // 网络配置\n url?: string;\n // 认证配置\n apiKey?: string;\n headers?: Record<string, string>;\n customSSEOptions?: ModelScopeSSEOptions;\n}\n\n/\n 旧版 MCP 服务配置接口（包含 name 字段）\n * 用于向后兼容\n /\nexport interface LegacyMCPServiceConfig extends MCPServiceConfig {\n name: string;\n}\n\n/\n 内部使用的 MCP 服务配置接口（包含 name 字段）\n * 用于 TransportFactory 等内部函数\n /\nexport interface InternalMCPServiceConfig extends MCPServiceConfig {\n name: string;\n}\n\n// =========================\n// 3. 状态枚举类型\n// =========================\n\n/\n 连接状态枚举\n /\nexport enum ConnectionState {\n DISCONNECTED = \"disconnected\",\n CONNECTING = \"connecting\",\n CONNECTED = \"connected\",\n RECONNECTING = \"reconnecting\",\n FAILED = \"failed\",\n ERROR = \"error\",\n}\n\n/\n MCP 服务状态接口\n /\nexport interface MCPServiceStatus {\n name: string;\n connected: boolean;\n initialized: boolean;\n transportType: MCPTransportType;\n toolCount: number;\n lastError?: string;\n connectionState: ConnectionState;\n}\n\n// =========================\n// 4. 工具调用相关类型\n// =========================\n\n/\n 工具调用结果接口\n /\nexport interface ToolCallResult {\n content: Array<{\n type: string;\n text: string;\n }>;\n isError?: boolean;\n}\n\n/\n JSON Schema 类型定义\n /\nexport type JSONSchema =\n \| (Record<string, unknown> & {\n type: \"object\";\n properties?: Record<string, unknown>;\n required?: string[];\n additionalProperties?: boolean;\n })\n \| Record<string, unknown>;\n\n/\n 类型守卫：检查对象是否为有效的 MCP Tool JSON Schema\n /\nexport function isValidToolJSONSchema(obj: unknown): obj is {\n type: \"object\";\n properties?: Record<string, unknown>;\n required?: string[];\n additionalProperties?: boolean;\n} {\n return (\n typeof obj === \"object\" &&\n obj !== null &&\n \"type\" in obj &&\n (obj as { type?: unknown }).type === \"object\"\n );\n}\n\n/\n 确保对象符合 MCP Tool JSON Schema 格式\n /\nexport function ensureToolJSONSchema(schema: JSONSchema): {\n type: \"object\";\n properties?: Record<string, object>;\n required?: string[];\n additionalProperties?: boolean;\n} {\n if (isValidToolJSONSchema(schema)) {\n return schema as {\n type: \"object\";\n properties?: Record<string, object>;\n required?: string[];\n additionalProperties?: boolean;\n };\n }\n\n return {\n type: \"object\",\n properties: {} as Record<string, object>,\n required: [],\n additionalProperties: true,\n };\n}\n\n/\n CustomMCP 工具类型定义\n /\nexport interface CustomMCPTool {\n name: string;\n description?: string;\n inputSchema: JSONSchema;\n handler?: {\n type: string;\n config?: Record<string, unknown>;\n };\n}\n\n/\n 工具信息接口\n /\nexport interface ToolInfo {\n serviceName: string;\n originalName: string;\n tool: Tool;\n}\n\n// =========================\n// 5. 增强工具信息类型\n// =========================\n\n/\n 工具状态过滤选项\n /\nexport type ToolStatusFilter = \"enabled\" \| \"disabled\" \| \"all\";\n\n/\n 增强的工具信息接口\n /\nexport interface EnhancedToolInfo {\n /* 工具唯一标识符，格式为 \"{serviceName}__{originalName}\" /\n name: string;\n /* 工具描述信息 /\n description: string;\n /* 工具输入参数的 JSON Schema 定义 /\n inputSchema: JSONSchema;\n /* 工具所属的 MCP 服务名称 /\n serviceName: string;\n /* 工具在 MCP 服务中的原始名称 /\n originalName: string;\n /* 工具是否启用 /\n enabled: boolean;\n /* 工具使用次数统计 /\n usageCount: number;\n /* 工具最后使用时间 /\n lastUsedTime: string;\n}\n\n// =========================\n// 6. 服务器配置类型\n// =========================\n\n/\n 统一服务器配置接口\n /\nexport interface UnifiedServerConfig {\n name?: string;\n enableLogging?: boolean;\n logLevel?: string;\n configs?: Record<string, MCPServiceConfig>;\n}\n\n/\n 统一服务器状态接口\n /\nexport interface UnifiedServerStatus {\n isRunning: boolean;\n serviceStatus: ManagerStatus;\n transportCount: number;\n activeConnections: number;\n config: UnifiedServerConfig;\n services?: Record<string, MCPServiceConnectionStatus>;\n totalTools?: number;\n availableTools?: string[];\n}\n\n// =========================\n// 7. 管理器相关类型\n// =========================\n\n/\n MCP 服务连接状态接口\n /\nexport interface MCPServiceConnectionStatus {\n connected: boolean;\n clientName: string;\n}\n\n/\n 管理器状态接口\n /\nexport interface ManagerStatus {\n services: Record<string, MCPServiceConnectionStatus>;\n totalTools: number;\n availableTools: string[];\n}\n\n// =========================\n// 8. 参数校验相关类型\n// =========================\n\n/\n 工具调用参数接口\n /\nexport interface ToolCallParams {\n name: string;\n arguments?: Record<string, unknown>;\n}\n\n/\n 验证后的工具调用参数\n /\nexport interface ValidatedToolCallParams {\n name: string;\n arguments?: Record<string, unknown>;\n}\n\n/\n 工具调用验证选项\n /\nexport interface ToolCallValidationOptions {\n validateName?: boolean;\n validateArguments?: boolean;\n allowEmptyArguments?: boolean;\n customValidator?: (params: ToolCallParams) => string \| null;\n}\n\n/\n 工具调用错误码枚举\n /\nexport enum ToolCallErrorCode {\n INVALID_PARAMS = -32602,\n TOOL_NOT_FOUND = -32601,\n SERVICE_UNAVAILABLE = -32001,\n TIMEOUT = -32002,\n TOOL_EXECUTION_ERROR = -32000,\n}\n\n/\n 工具调用错误类\n /\nexport class ToolCallError extends Error {\n constructor(\n public code: ToolCallErrorCode,\n message: string,\n public data?: unknown\n ) {\n super(message);\n this.name = \"ToolCallError\";\n }\n}\n","import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { MCPServerTransport, MCPServiceConfig, MCPServiceStatus, ToolCallResult } from \"./types.js\";\nimport { ConnectionState, MCPTransportType } from \"./types.js\";\nimport { TransportFactory } from \"./transport-factory.js\";\nimport { inferTransportTypeFromConfig } from \"./utils/index.js\";\n\n/\n MCP 连接类\n * 负责管理单个 MCP 服务的连接、工具管理和调用\n /\nexport class MCPConnection {\n private name: string; // 服务名称（独立字段）\n private config: MCPServiceConfig;\n private client: Client \| null = null;\n private transport: MCPServerTransport \| null = null;\n private tools: Map<string, Tool> = new Map();\n private connectionState: ConnectionState = ConnectionState.DISCONNECTED;\n private connectionTimeout: NodeJS.Timeout \| null = null;\n private initialized = false;\n private callbacks?: import(\"./types.js\").MCPServiceEventCallbacks;\n\n constructor(\n name: string,\n config: MCPServiceConfig,\n callbacks?: import(\"./types.js\").MCPServiceEventCallbacks\n ) {\n this.name = name;\n // 使用工具方法推断服务类型（传递服务名称用于日志）\n this.config = inferTransportTypeFromConfig(config, name);\n this.callbacks = callbacks;\n\n // 验证配置\n this.validateConfig();\n }\n\n /\n 验证配置\n /\n private validateConfig(): void {\n // 验证服务名称\n if (!this.name \|\| typeof this.name !== \"string\") {\n throw new Error(\"服务名称必须是非空字符串\");\n }\n // 使用 TransportFactory 进行配置验证（传递包含 name 的完整配置）\n const fullConfig: import(\"./types.js\").InternalMCPServiceConfig = {\n name: this.name,\n ...this.config,\n };\n TransportFactory.validateConfig(fullConfig);\n }\n\n /\n 连接到 MCP 服务\n /\n async connect(): Promise<void> {\n // 如果正在连接中，等待当前连接完成\n if (this.connectionState === ConnectionState.CONNECTING) {\n throw new Error(\"连接正在进行中，请等待连接完成\");\n }\n\n // 清理之前的连接\n this.cleanupConnection();\n\n return this.attemptConnection();\n }\n\n /\n 尝试建立连接\n /\n private async attemptConnection(): Promise<void> {\n this.connectionState = ConnectionState.CONNECTING;\n console.debug(\n `[MCP-${this.name}] 正在连接 MCP 服务: ${this.name}`\n );\n\n return new Promise((resolve, reject) => {\n // 设置连接超时（使用固定默认值 30 秒）\n const CONNECTION_TIMEOUT = 30000;\n this.connectionTimeout = setTimeout(() => {\n const error = new Error(`连接超时 (${CONNECTION_TIMEOUT}ms)`);\n this.handleConnectionError(error);\n reject(error);\n }, CONNECTION_TIMEOUT);\n\n try {\n this.client = new Client(\n {\n name: `xiaozhi-${this.name}-client`,\n version: \"1.0.0\",\n },\n {\n capabilities: {},\n }\n );\n\n // 使用 TransportFactory 创建传输层（传递包含 name 的完整配置）\n const fullConfig: import(\"./types.js\").InternalMCPServiceConfig = {\n name: this.name,\n ...this.config,\n };\n this.transport = TransportFactory.create(fullConfig);\n\n // 连接到 MCP 服务\n this.client\n .connect(this.transport as MCPServerTransport)\n .then(async () => {\n this.handleConnectionSuccess();\n\n // 获取工具列表\n await this.refreshTools();\n\n // 发射连接成功事件\n this.callbacks?.onConnected?.({\n serviceName: this.name,\n tools: this.getTools(),\n connectionTime: new Date(),\n });\n\n resolve();\n })\n .catch((error) => {\n this.handleConnectionError(error);\n reject(error);\n });\n } catch (error) {\n this.handleConnectionError(error as Error);\n reject(error);\n }\n });\n }\n\n /\n 处理连接成功\n /\n private handleConnectionSuccess(): void {\n // 清理连接超时定时器\n if (this.connectionTimeout) {\n clearTimeout(this.connectionTimeout);\n this.connectionTimeout = null;\n }\n\n this.connectionState = ConnectionState.CONNECTED;\n this.initialized = true;\n\n console.info(\n `[MCP-${this.name}] MCP 服务 ${this.name} 连接已建立`\n );\n }\n\n /\n 处理连接错误\n /\n private handleConnectionError(error: Error): void {\n this.connectionState = ConnectionState.DISCONNECTED;\n this.initialized = false;\n\n console.debug(`MCP 服务 ${this.name} 连接错误:`, error.message);\n\n // 清理连接超时定时器\n if (this.connectionTimeout) {\n clearTimeout(this.connectionTimeout);\n this.connectionTimeout = null;\n }\n\n // 清理当前连接\n this.cleanupConnection();\n\n // 发射连接失败事件\n this.callbacks?.onConnectionFailed?.({\n serviceName: this.name,\n error,\n attempt: 0,\n });\n }\n\n /\n 清理连接资源\n /\n private cleanupConnection(): void {\n // 清理客户端\n if (this.client) {\n try {\n this.client.close().catch(() => {\n // 忽略关闭时的错误\n });\n } catch (error) {\n // 忽略关闭时的错误\n }\n this.client = null;\n }\n\n // 清理传输层\n this.transport = null;\n\n // 清理连接超时定时器\n if (this.connectionTimeout) {\n clearTimeout(this.connectionTimeout);\n this.connectionTimeout = null;\n }\n\n // 重置状态\n this.initialized = false;\n }\n\n /\n 刷新工具列表\n /\n private async refreshTools(): Promise<void> {\n if (!this.client) {\n throw new Error(\"客户端未初始化\");\n }\n\n try {\n const toolsResult = await this.client.listTools();\n const tools: Tool[] = toolsResult.tools \|\| [];\n\n // 清空现有工具\n this.tools.clear();\n\n // 注册工具到映射表\n for (const tool of tools) {\n this.tools.set(tool.name, tool);\n }\n\n console.debug(\n `${this.name} 服务加载了 ${tools.length} 个工具: ${tools\n .map((t) => t.name)\n .join(\", \")}`\n );\n } catch (error) {\n console.error(\n `${this.name} 获取工具列表失败:`,\n error instanceof Error ? error.message : String(error)\n );\n throw error;\n }\n }\n\n /\n 断开连接\n /\n async disconnect(): Promise<void> {\n console.info(`主动断开 MCP 服务 ${this.name} 连接`);\n\n // 清理连接资源\n this.cleanupConnection();\n\n // 设置状态为已断开\n this.connectionState = ConnectionState.DISCONNECTED;\n\n // 发射断开连接事件\n this.callbacks?.onDisconnected?.({\n serviceName: this.name,\n reason: \"手动断开\",\n disconnectionTime: new Date(),\n });\n }\n\n /\n 获取工具列表\n /\n getTools(): Tool[] {\n return Array.from(this.tools.values());\n }\n\n /\n 调用工具\n /\n async callTool(\n name: string,\n arguments_: Record<string, unknown>\n ): Promise<ToolCallResult> {\n if (!this.client) {\n throw new Error(`服务 ${this.name} 未连接`);\n }\n\n if (!this.tools.has(name)) {\n throw new Error(`工具 ${name} 在服务 ${this.name} 中不存在`);\n }\n\n console.debug(\n `调用 ${this.name} 服务的工具 ${name}，参数:`,\n JSON.stringify(arguments_)\n );\n\n try {\n const result = await this.client.callTool({\n name,\n arguments: arguments_ \|\| {},\n });\n\n console.debug(\n `工具 ${name} 调用成功，结果:`,\n `${JSON.stringify(result).substring(0, 500)}...`\n );\n\n return result as ToolCallResult;\n } catch (error) {\n console.error(\n `工具 ${name} 调用失败:`,\n error instanceof Error ? error.message : String(error)\n );\n throw error;\n }\n }\n\n /\n 获取服务配置\n /\n getConfig(): MCPServiceConfig & { name: string } {\n return {\n name: this.name,\n ...this.config,\n };\n }\n\n /\n 获取服务状态\n /\n getStatus(): MCPServiceStatus {\n return {\n name: this.name,\n connected: this.connectionState === ConnectionState.CONNECTED,\n initialized: this.initialized,\n transportType:\n (this.config.type as MCPTransportType) \|\| MCPTransportType.HTTP,\n toolCount: this.tools.size,\n connectionState: this.connectionState,\n };\n }\n\n /\n 检查是否已连接\n /\n isConnected(): boolean {\n return (\n this.connectionState === ConnectionState.CONNECTED && this.initialized\n );\n }\n}\n","import type { InternalMCPServiceConfig, MCPServerTransport } from \"./types.js\";\nimport { MCPTransportType } from \"./types.js\";\nimport type { SSEClientTransportOptions } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { StreamableHTTPClientTransportOptions } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { EventSource } from \"eventsource\";\n\n// 全局 polyfill EventSource（用于 SSE）\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst globalThisAny: any = typeof globalThis !== \"undefined\" ? globalThis : global;\nif (\n typeof globalThisAny !== \"undefined\" &&\n !globalThisAny.EventSource\n) {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n globalThisAny.EventSource = EventSource;\n}\n\n// Transport 基础接口\nexport interface Transport {\n connect?(): Promise<void>;\n close?(): Promise<void>;\n}\n\n/\n 创建 transport 实例\n * @param config MCP 服务配置（包含 name）\n * @returns transport 实例\n /\nexport function createTransport(config: InternalMCPServiceConfig): MCPServerTransport {\n console.debug(\n `[TransportFactory] 创建 ${config.type} transport for ${config.name}`\n );\n\n switch (config.type) {\n case MCPTransportType.STDIO:\n return createStdioTransport(config);\n\n case MCPTransportType.SSE:\n return createSSETransport(config);\n\n case MCPTransportType.HTTP:\n return createHTTPTransport(config);\n\n default:\n throw new Error(`不支持的传输类型: ${config.type}`);\n }\n}\n\n/\n 创建 Stdio transport\n /\nfunction createStdioTransport(config: InternalMCPServiceConfig): StdioClientTransport {\n if (!config.command) {\n throw new Error(\"stdio transport 需要 command 配置\");\n }\n\n return new StdioClientTransport({\n command: config.command,\n args: config.args \|\| [],\n env: config.env, // 传递环境变量\n });\n}\n\n/\n 创建 SSE transport\n /\nfunction createSSETransport(config: InternalMCPServiceConfig): SSEClientTransport {\n if (!config.url) {\n throw new Error(\"SSE transport 需要 URL 配置\");\n }\n\n const url = new URL(config.url);\n const options = createSSEOptions(config);\n\n return new SSEClientTransport(url, options);\n}\n\nfunction createHTTPTransport(\n config: InternalMCPServiceConfig\n): StreamableHTTPClientTransport {\n if (!config.url) {\n throw new Error(\"HTTP transport 需要 URL 配置\");\n }\n\n const url = new URL(config.url);\n const options = createStreamableHTTPOptions(config);\n return new StreamableHTTPClientTransport(url, options);\n}\n\n/\n 创建 SSE 选项\n /\nfunction createSSEOptions(config: InternalMCPServiceConfig): SSEClientTransportOptions {\n const options: SSEClientTransportOptions = {};\n\n // 添加认证头\n if (config.apiKey) {\n options.requestInit = {\n headers: {\n Authorization: `Bearer ${config.apiKey}`,\n ...config.headers,\n },\n };\n } else if (config.headers) {\n options.requestInit = {\n headers: config.headers,\n };\n }\n\n return options;\n}\n\nfunction createStreamableHTTPOptions(\n config: InternalMCPServiceConfig\n): StreamableHTTPClientTransportOptions {\n const options: StreamableHTTPClientTransportOptions = {};\n\n // 添加认证头\n if (config.apiKey) {\n options.requestInit = {\n headers: {\n Authorization: `Bearer ${config.apiKey}`,\n ...config.headers,\n },\n };\n } else if (config.headers) {\n options.requestInit = {\n headers: config.headers,\n };\n }\n\n return options;\n}\n\n/\n 验证配置\n * 注意：name 验证已在 MCPConnection 构造函数中进行\n * @param config MCP 服务配置（包含 name）\n /\nexport function validateConfig(config: InternalMCPServiceConfig): void {\n // name 验证已移至 MCPConnection 构造函数\n\n // type 字段现在是可选的，由 MCPService 自动推断\n // 这里我们只验证如果 type 存在，必须是有效的类型\n if (\n config.type &&\n !Object.values(MCPTransportType).includes(config.type as MCPTransportType)\n ) {\n throw new Error(`不支持的传输类型: ${config.type}`);\n }\n\n // 注意：这个验证方法在 MCPService.inferTransportType 之后调用\n // 此时 config.type 应该已经被推断或显式设置\n if (!config.type) {\n throw new Error(\"传输类型未设置，这应该在 inferTransportType 中处理\");\n }\n\n switch (config.type) {\n case MCPTransportType.STDIO:\n if (!config.command) {\n throw new Error(\"stdio 类型需要 command 字段\");\n }\n break;\n\n case MCPTransportType.SSE:\n if (config.url === undefined \|\| config.url === null) {\n throw new Error(`${config.type} 类型需要 url 字段`);\n }\n break;\n case MCPTransportType.HTTP:\n // HTTP 允许空 URL，会在后续处理中设置默认值\n if (config.url === undefined \|\| config.url === null) {\n throw new Error(`${config.type} 类型需要 url 字段`);\n }\n break;\n\n default:\n throw new Error(`不支持的传输类型: ${config.type}`);\n }\n}\n\n/\n 获取支持的传输类型列表\n /\nexport function getSupportedTypes(): MCPTransportType[] {\n return [\n MCPTransportType.STDIO,\n MCPTransportType.SSE,\n MCPTransportType.HTTP,\n ];\n}\n\n/\n Transport 工厂对象（保持 API 兼容性）\n /\nexport const TransportFactory = {\n create: createTransport,\n validateConfig,\n getSupportedTypes,\n};\n","/\n MCP 服务器配置 Type 字段标准化工具\n * 支持将各种 type 字段格式转换为 MCP 官方标准格式\n \n @description\n * 标准格式与 MCP 官方保持一致：\n * - stdio: 本地进程通信\n * - sse: Server-Sent Events\n * - http: Streamable HTTP（推荐使用 http 而非 streamable-http）\n \n 向后兼容：自动转换各种变体格式\n /\n\n/\n MCP 服务器配置的基础接口\n * 定义包含可选 type 字段的配置对象结构\n /\nexport interface MCPBaseConfig {\n type?: string;\n [key: string]: unknown; // 允许其他配置属性\n}\n\n/\n MCP 服务器配置 Type 字段标准化工具类\n /\nexport namespace TypeFieldNormalizer {\n /\n 标准化 type 字段格式\n \n 支持的转换：\n * - http 变体：http → http（标准值）\n * - streamable-http → http\n * - streamable_http → http\n * - streamableHttp → http\n * - sse 变体：sse → sse（标准值）\n * - s_se → sse\n * - s-se → sse\n * - stdio 变体：stdio → stdio（标准值）\n /\n // 函数重载：泛型版本，用于类型安全的调用\n export function normalizeTypeField<T extends MCPBaseConfig>(config: T): T;\n\n // 函数重载：向后兼容版本，用于 unknown 类型输入\n export function normalizeTypeField(config: unknown): unknown;\n\n // 统一实现\n export function normalizeTypeField<T extends MCPBaseConfig>(\n config: T \| unknown\n ): T \| unknown {\n if (!config \|\| typeof config !== \"object\") {\n return config;\n }\n\n // 创建配置的深拷贝以避免修改原始对象\n const normalizedConfig = JSON.parse(JSON.stringify(config));\n\n // 如果配置中没有 type 字段，直接返回\n if (!(\"type\" in normalizedConfig)) {\n return normalizedConfig;\n }\n\n const originalType = normalizedConfig.type;\n\n // 如果已经是标准格式，直接返回\n if (originalType === \"stdio\" \|\| originalType === \"sse\" \|\| originalType === \"http\") {\n return normalizedConfig;\n }\n\n // 转换为标准格式\n const normalizedType = normalizeTypeValue(originalType);\n\n // 验证转换后的类型是否有效\n if (normalizedType === \"stdio\" \|\| normalizedType === \"sse\" \|\| normalizedType === \"http\") {\n normalizedConfig.type = normalizedType;\n }\n\n return normalizedConfig;\n }\n\n /\n 标准化单个 type 值\n /\n export function normalizeTypeValue(type: string): string {\n // http 相关的变体全部转为 http\n if (\n type === \"http\" \|\|\n type === \"streamable-http\" \|\|\n type === \"streamable_http\" \|\|\n type === \"streamableHttp\"\n ) {\n return \"http\";\n }\n\n // sse 相关的变体转为 sse\n if (type === \"sse\" \|\| type === \"s_se\" \|\| type === \"s-se\") {\n return \"sse\";\n }\n\n // stdio 相关的变体转为 stdio\n if (type === \"stdio\") {\n return \"stdio\";\n }\n\n // 对于其他格式，尝试智能转换（转小写、下划线转中划线等）\n return convertToStandardFormat(type);\n }\n\n /\n 将字符串转换为标准格式\n /\n function convertToStandardFormat(str: string): string {\n const lowered = str.toLowerCase();\n\n // 处理 http 相关的变体\n if (lowered.includes(\"http\") \|\| lowered.includes(\"streamable\")) {\n return \"http\";\n }\n\n // 处理 sse 相关的变体\n if (lowered.includes(\"sse\")) {\n return \"sse\";\n }\n\n // 处理 stdio 相关的变体\n if (lowered.includes(\"stdio\")) {\n return \"stdio\";\n }\n\n // 无法识别的格式，返回原值\n return str;\n }\n}\n\n/\n 导出便捷函数\n /\nexport function normalizeTypeField<T extends MCPBaseConfig>(\n config: T\n): T;\nexport function normalizeTypeField(config: unknown): unknown;\nexport function normalizeTypeField<T extends MCPBaseConfig>(\n config: T \| unknown\n): T \| unknown {\n return TypeFieldNormalizer.normalizeTypeField(config);\n}\n","import { MCPTransportType, ToolCallError, ToolCallErrorCode } from \"../types.js\";\nimport { TypeFieldNormalizer } from \"./type-normalizer.js\";\nimport type {\n MCPServiceConfig,\n ToolCallParams,\n ToolCallValidationOptions,\n ValidatedToolCallParams,\n} from \"../types.js\";\n\n/\n 根据 URL 路径推断传输类型\n * 基于路径末尾推断，支持包含多个 / 的复杂路径\n \n @param url - 要推断的 URL\n * @param options - 可选配置项\n * @returns 推断出的传输类型\n /\nexport function inferTransportTypeFromUrl(\n url: string,\n options?: {\n serviceName?: string;\n }\n): MCPTransportType {\n try {\n const parsedUrl = new URL(url);\n const pathname = parsedUrl.pathname;\n\n // 检查路径末尾\n if (pathname.endsWith(\"/sse\")) {\n return MCPTransportType.SSE;\n }\n if (pathname.endsWith(\"/mcp\")) {\n return MCPTransportType.HTTP;\n }\n\n // 默认类型 - 使用 console 输出\n if (options?.serviceName) {\n console.info(\n `[MCP-${options.serviceName}] URL 路径 ${pathname} 不匹配特定规则，默认推断为 http 类型`\n );\n }\n return MCPTransportType.HTTP;\n } catch (error) {\n if (options?.serviceName) {\n console.warn(\n `[MCP-${options.serviceName}] URL 解析失败，默认推断为 http 类型`,\n error\n );\n }\n return MCPTransportType.HTTP;\n }\n}\n\n/\n 完整的配置类型推断（包括 command 字段）\n \n @param config - MCP 服务配置\n * @param serviceName - 服务名称（用于日志输出）\n * @returns 完整的配置对象，包含推断出的类型\n /\nexport function inferTransportTypeFromConfig(\n config: MCPServiceConfig,\n serviceName?: string\n): MCPServiceConfig {\n // 如果已显式指定类型，先标准化然后返回\n if (config.type) {\n const normalizedConfig = TypeFieldNormalizer.normalizeTypeField(config);\n return normalizedConfig as MCPServiceConfig;\n }\n\n // 基于 command 字段推断\n if (config.command) {\n return {\n ...config,\n type: MCPTransportType.STDIO,\n };\n }\n\n // 基于 URL 字段推断（排除 null 和 undefined）\n if (config.url !== undefined && config.url !== null) {\n const inferredType = inferTransportTypeFromUrl(config.url, {\n serviceName,\n });\n return {\n ...config,\n type: inferredType,\n };\n }\n\n throw new Error(\n `无法为服务 ${serviceName \|\| \"未知\"} 推断传输类型。请显式指定 type 字段，或提供 command/url 配置`\n );\n}\n\n// =========================\n// 参数校验工具函数\n// =========================\n\n/\n 验证工具调用参数\n * 对传入的参数进行完整性和格式验证\n \n @param params 待验证的参数\n * @param options 验证选项\n * @returns 验证后的参数\n * @throws ToolCallError 验证失败时抛出\n /\nexport function validateToolCallParams(\n params: unknown,\n options?: ToolCallValidationOptions\n): ValidatedToolCallParams {\n const opts = {\n validateName: true,\n validateArguments: true,\n allowEmptyArguments: true,\n ...options,\n };\n\n // 1. 验证参数必须是对象\n if (!params \|\| typeof params !== \"object\") {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"请求参数必须是对象\"\n );\n }\n\n const paramsObj = params as Record<string, unknown>;\n\n // 2. 验证工具名称\n if (opts.validateName) {\n if (!paramsObj.name \|\| typeof paramsObj.name !== \"string\") {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"工具名称必须是非空字符串\"\n );\n }\n }\n\n // 3. 验证工具参数格式\n if (\n opts.validateArguments &&\n paramsObj.arguments !== undefined &&\n paramsObj.arguments !== null\n ) {\n if (\n typeof paramsObj.arguments !== \"object\" \|\|\n Array.isArray(paramsObj.arguments)\n ) {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"工具参数必须是对象\"\n );\n }\n }\n\n // 4. 验证是否允许空参数\n if (\n !opts.allowEmptyArguments &&\n paramsObj.arguments !== undefined &&\n paramsObj.arguments !== null\n ) {\n const argsObj = paramsObj.arguments as Record<string, unknown>;\n if (Object.keys(argsObj).length === 0) {\n throw new ToolCallError(\n ToolCallErrorCode.INVALID_PARAMS,\n \"工具参数不能为空\"\n );\n }\n }\n\n // 5. 执行自定义验证\n if (opts.customValidator) {\n const error = opts.customValidator(paramsObj as unknown as ToolCallParams);\n if (error) {\n throw new ToolCallError(ToolCallErrorCode.INVALID_PARAMS, error);\n }\n }\n\n return {\n name: paramsObj.name as string,\n arguments: paramsObj.arguments as Record<string, unknown>,\n };\n}\n","/\n MCP 服务管理器\n * 提供简洁的 API 来管理多个 MCP 服务\n /\n\nimport { EventEmitter } from \"node:events\";\nimport { MCPConnection } from \"./connection.js\";\nimport type { MCPServiceConfig, ToolCallResult } from \"./types.js\";\nimport { MCPTransportType } from \"./types.js\";\n\n/\n MCP 服务管理器\n * 提供简洁的 API 来管理多个 MCP 服务\n \n @example\n * ```typescript\n * const manager = new MCPManager();\n \n // 添加服务\n * manager.addServer('datetime', {\n * type: 'stdio',\n * command: 'node',\n * args: ['datetime.js']\n * });\n \n // 连接所有服务\n * await manager.connect();\n \n // 调用工具\n * const result = await manager.callTool('datetime', 'get_current_time', {\n * format: 'YYYY-MM-DD HH:mm:ss'\n * });\n \n // 断开连接\n * await manager.disconnect();\n * ```\n /\nexport class MCPManager extends EventEmitter {\n private connections: Map<string, MCPConnection> = new Map();\n private configs: Map<string, MCPServiceConfig> = new Map();\n\n constructor() {\n super();\n }\n\n /\n 添加 MCP 服务器配置\n * @param name 服务器名称\n * @param config 服务器配置\n \n @example\n * ```typescript\n * // 添加 stdio 服务\n * manager.addServer('calculator', {\n * type: 'stdio',\n * command: 'node',\n * args: ['calculator.js']\n * });\n \n // 添加 HTTP 服务\n * manager.addServer('web-search', {\n * type: 'http',\n * url: 'https://api.example.com/mcp',\n * headers: {\n * Authorization: 'Bearer your-api-key'\n * }\n * });\n * ```\n /\n addServer(\n name: string,\n config: MCPServiceConfig\n ): void {\n if (this.configs.has(name)) {\n throw new Error(`服务 ${name} 已存在`);\n }\n\n // 标准化 type 字段 - 将用户友好的类型映射到实际的枚举值\n const normalizedConfig: MCPServiceConfig = { ...config };\n\n if (config.type) {\n // 首先检查用户友好的字符串类型\n const typeStr = String(config.type);\n if (typeStr === \"http\") {\n normalizedConfig.type = MCPTransportType.HTTP;\n } else if (typeStr === \"sse\") {\n normalizedConfig.type = MCPTransportType.SSE;\n } else {\n // 已经是枚举值或正确格式\n normalizedConfig.type = config.type as MCPTransportType;\n }\n }\n\n // 存储 config（不包含 name，name 已作为 Map 的 key）\n this.configs.set(name, normalizedConfig);\n }\n\n /\n 移除服务器配置\n * @param name 服务器名称\n /\n removeServer(name: string): boolean {\n return this.configs.delete(name);\n }\n\n /\n 连接所有已添加的 MCP 服务\n * 所有服务并行连接，单个服务失败不会影响其他服务\n \n @example\n * ```typescript\n * await manager.connect();\n * ```\n /\n async connect(): Promise<void> {\n this.emit(\"connect\");\n\n const promises = Array.from(this.configs.entries()).map(\n async ([name, config]) => {\n try {\n const connection = new MCPConnection(name, config, {\n onConnected: (data) => {\n this.emit(\"connected\", {\n serverName: data.serviceName,\n tools: data.tools,\n });\n },\n onDisconnected: (data) => {\n this.emit(\"disconnected\", {\n serverName: data.serviceName,\n reason: data.reason,\n });\n },\n onConnectionFailed: (data) => {\n this.emit(\"error\", {\n serverName: data.serviceName,\n error: data.error,\n });\n },\n });\n\n await connection.connect();\n this.connections.set(name, connection);\n } catch (error) {\n this.emit(\"error\", { serverName: name, error });\n throw error;\n }\n }\n );\n\n await Promise.allSettled(promises);\n }\n\n /\n 断开所有 MCP 服务连接\n \n @example\n * ```typescript\n * await manager.disconnect();\n * ```\n /\n async disconnect(): Promise<void> {\n const promises = Array.from(this.connections.values()).map((conn) =>\n conn.disconnect()\n );\n\n await Promise.allSettled(promises);\n this.connections.clear();\n\n this.emit(\"disconnect\");\n }\n\n /\n 调用指定服务的工具\n * @param serverName 服务名称\n * @param toolName 工具名称\n * @param args 工具参数\n \n @example\n * ```typescript\n * const result = await manager.callTool('datetime', 'get_current_time', {\n * format: 'YYYY-MM-DD HH:mm:ss'\n * });\n * ```\n /\n async callTool(\n serverName: string,\n toolName: string,\n args: Record<string, unknown>\n ): Promise<ToolCallResult> {\n const connection = this.connections.get(serverName);\n if (!connection) {\n throw new Error(`服务 ${serverName} 不存在`);\n }\n\n if (!connection.isConnected()) {\n throw new Error(`服务 ${serverName} 未连接`);\n }\n\n return connection.callTool(toolName, args);\n }\n\n /\n 列出所有可用的工具\n * @returns 工具列表，格式为 [{ name, serverName, description, inputSchema }]\n \n @example\n * ```typescript\n * const tools = manager.listTools();\n * console.log('可用工具:', tools.map(t => `${t.serverName}/${t.name}`));\n * ```\n /\n listTools(): Array<{\n name: string;\n serverName: string;\n description: string;\n inputSchema: unknown;\n }> {\n const allTools: Array<{\n name: string;\n serverName: string;\n description: string;\n inputSchema: unknown;\n }> = [];\n\n for (const [serverName, connection] of this.connections) {\n if (connection.isConnected()) {\n const tools = connection.getTools();\n for (const tool of tools) {\n allTools.push({\n name: tool.name,\n serverName,\n description: tool.description \|\| \"\",\n inputSchema: tool.inputSchema,\n });\n }\n }\n }\n\n return allTools;\n }\n\n /\n 获取服务状态\n * @param serverName 服务名称\n * @returns 服务状态，如果服务不存在则返回 null\n \n @example\n * ```typescript\n * const status = manager.getServerStatus('datetime');\n * if (status) {\n * console.log(`已连接: ${status.connected}, 工具数: ${status.toolCount}`);\n * }\n * ```\n /\n getServerStatus(serverName: string): {\n connected: boolean;\n toolCount: number;\n } \| null {\n const connection = this.connections.get(serverName);\n if (!connection) {\n return null;\n }\n\n const status = connection.getStatus();\n return {\n connected: status.connected,\n toolCount: status.toolCount,\n };\n }\n\n /\n 获取所有服务的状态\n * @returns 所有服务的状态映射\n \n @example\n * ```typescript\n * const statuses = manager.getAllServerStatus();\n * console.log(statuses);\n * // {\n * // datetime: { connected: true, toolCount: 3 },\n * // calculator: { connected: true, toolCount: 1 }\n * // }\n * ```\n /\n getAllServerStatus(): Record<\n string,\n { connected: boolean; toolCount: number }\n > {\n const statuses: Record<string, { connected: boolean; toolCount: number }> =\n {};\n\n for (const [serverName, connection] of this.connections) {\n const status = connection.getStatus();\n statuses[serverName] = {\n connected: status.connected,\n toolCount: status.toolCount,\n };\n }\n\n return statuses;\n }\n\n /\n 检查服务是否已连接\n * @param serverName 服务名称\n \n @example\n * ```typescript\n * if (manager.isConnected('datetime')) {\n * console.log('datetime 服务已连接');\n * }\n * ```\n /\n isConnected(serverName: string): boolean {\n const connection = this.connections.get(serverName);\n return connection ? connection.isConnected() : false;\n }\n\n /\n 获取已配置的服务列表\n * @returns 服务名称数组\n \n @example\n * ```typescript\n * const servers = manager.getServerNames();\n * console.log('已配置的服务:', servers);\n * ```\n /\n getServerNames(): string[] {\n return Array.from(this.configs.keys());\n }\n\n /\n 获取已连接的服务列表\n * @returns 已连接的服务名称数组\n \n @example\n * ```typescript\n * const connectedServers = manager.getConnectedServerNames();\n * console.log('已连接的服务:', connectedServers);\n * ```\n */\n getConnectedServerNames(): string[] {\n const connected: string[] = [];\n for (const [serverName, connection] of this.connections) {\n if (connection.isConnected()) {\n connected.push(serverName);\n }\n }\n return connected;\n }\n}\n\n// 为了向后兼容，保留旧的 MCPServiceManager 类名作为别名\nexport { MCPManager as MCPServiceManager };\n"],"mappings":"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","names":["MCPTransportType","ConnectionState","ToolCallErrorCode","TypeFieldNormalizer","normalizeTypeField"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@xiaozhi-client/mcp-core",
-  "version": "1.9.7-beta.9",
+  "version": "1.9.8-beta.0",
   "description": "MCP 协议核心实现，提供服务连接和管理功能",
   "type": "module",
   "main": "./dist/index.js",