@xiaozhi-client/mcp-core 1.9.7-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 shenjingnan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,295 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { EventEmitter } from 'node:events';
+
+/**
+ * MCP 核心库类型定义
+ * 统一管理所有 MCP 相关的类型定义
+ */
+
+/**
+ * 通信方式枚举
+ * 定义 MCP 支持的传输类型
+ */
+declare enum MCPTransportType {
+    STDIO = "stdio",
+    SSE = "sse",
+    STREAMABLE_HTTP = "streamable-http"
+}
+/**
+ * ModelScope SSE 自定义选项接口
+ */
+interface ModelScopeSSEOptions {
+    eventSourceInit?: {
+        fetch?: (url: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    };
+    requestInit?: RequestInit;
+}
+/**
+ * MCP 服务配置接口
+ * 包含所有 MCP 服务的配置选项
+ */
+interface MCPServiceConfig {
+    name: string;
+    type?: MCPTransportType;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    modelScopeAuth?: boolean;
+    customSSEOptions?: ModelScopeSSEOptions;
+    timeout?: number;
+    retryAttempts?: number;
+}
+/**
+ * 连接状态枚举
+ */
+declare enum ConnectionState {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    RECONNECTING = "reconnecting",
+    FAILED = "failed",
+    ERROR = "error"
+}
+/**
+ * MCP 服务状态接口
+ */
+interface MCPServiceStatus {
+    name: string;
+    connected: boolean;
+    initialized: boolean;
+    transportType: MCPTransportType;
+    toolCount: number;
+    lastError?: string;
+    connectionState: ConnectionState;
+}
+/**
+ * 工具调用结果接口
+ */
+interface ToolCallResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * JSON Schema 类型定义
+ */
+type JSONSchema = (Record<string, unknown> & {
+    type: "object";
+    properties?: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+}) | Record<string, unknown>;
+/**
+ * 类型守卫：检查对象是否为有效的 MCP Tool JSON Schema
+ */
+declare function isValidToolJSONSchema(obj: unknown): obj is {
+    type: "object";
+    properties?: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+};
+/**
+ * 确保对象符合 MCP Tool JSON Schema 格式
+ */
+declare function ensureToolJSONSchema(schema: JSONSchema): {
+    type: "object";
+    properties?: Record<string, object>;
+    required?: string[];
+    additionalProperties?: boolean;
+};
+/**
+ * CustomMCP 工具类型定义
+ */
+interface CustomMCPTool {
+    name: string;
+    description?: string;
+    inputSchema: JSONSchema;
+    handler?: {
+        type: string;
+        config?: Record<string, unknown>;
+    };
+}
+/**
+ * 工具信息接口
+ */
+interface ToolInfo {
+    serviceName: string;
+    originalName: string;
+    tool: Tool;
+}
+/**
+ * 工具状态过滤选项
+ */
+type ToolStatusFilter = "enabled" | "disabled" | "all";
+/**
+ * 增强的工具信息接口
+ */
+interface EnhancedToolInfo {
+    /** 工具唯一标识符，格式为 "{serviceName}__{originalName}" */
+    name: string;
+    /** 工具描述信息 */
+    description: string;
+    /** 工具输入参数的 JSON Schema 定义 */
+    inputSchema: JSONSchema;
+    /** 工具所属的 MCP 服务名称 */
+    serviceName: string;
+    /** 工具在 MCP 服务中的原始名称 */
+    originalName: string;
+    /** 工具是否启用 */
+    enabled: boolean;
+    /** 工具使用次数统计 */
+    usageCount: number;
+    /** 工具最后使用时间 */
+    lastUsedTime: string;
+}
+/**
+ * 统一服务器配置接口
+ */
+interface UnifiedServerConfig {
+    name?: string;
+    enableLogging?: boolean;
+    logLevel?: string;
+    configs?: Record<string, MCPServiceConfig>;
+}
+/**
+ * 统一服务器状态接口
+ */
+interface UnifiedServerStatus {
+    isRunning: boolean;
+    serviceStatus: ManagerStatus;
+    transportCount: number;
+    activeConnections: number;
+    config: UnifiedServerConfig;
+    services?: Record<string, MCPServiceConnectionStatus>;
+    totalTools?: number;
+    availableTools?: string[];
+}
+/**
+ * MCP 服务连接状态接口
+ */
+interface MCPServiceConnectionStatus {
+    connected: boolean;
+    clientName: string;
+}
+/**
+ * 管理器状态接口
+ */
+interface ManagerStatus {
+    services: Record<string, MCPServiceConnectionStatus>;
+    totalTools: number;
+    availableTools: string[];
+}
+/**
+ * 工具调用参数接口
+ */
+interface ToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+/**
+ * 验证后的工具调用参数
+ */
+interface ValidatedToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+/**
+ * 工具调用验证选项
+ */
+interface ToolCallValidationOptions {
+    validateName?: boolean;
+    validateArguments?: boolean;
+    allowEmptyArguments?: boolean;
+    customValidator?: (params: ToolCallParams) => string | null;
+}
+/**
+ * 工具调用错误码枚举
+ */
+declare enum ToolCallErrorCode {
+    INVALID_PARAMS = -32602,
+    TOOL_NOT_FOUND = -32601,
+    SERVICE_UNAVAILABLE = -32001,
+    TIMEOUT = -32002,
+    TOOL_EXECUTION_ERROR = -32000
+}
+/**
+ * 工具调用错误类
+ */
+declare class ToolCallError extends Error {
+    code: ToolCallErrorCode;
+    data?: unknown | undefined;
+    constructor(code: ToolCallErrorCode, message: string, data?: unknown | undefined);
+}
+
+/**
+ * 简化版 MCP 服务管理器
+ * 专门为 endpoint 包设计，提供核心 MCP 服务管理功能
+ */
+
+/**
+ * 简化版 MCP 服务管理器
+ * 提供 MCP 服务的核心管理功能
+ */
+declare class MCPServiceManager extends EventEmitter {
+    private configs;
+    private tools;
+    private isInitialized;
+    constructor(configs?: Record<string, MCPServiceConfig>);
+    /**
+     * 添加服务配置
+     */
+    addServiceConfig(name: string, config: MCPServiceConfig): void;
+    /**
+     * 更新服务配置
+     */
+    updateServiceConfig(name: string, config: MCPServiceConfig): void;
+    /**
+     * 移除服务配置
+     */
+    removeServiceConfig(name: string): void;
+    /**
+     * 获取所有服务配置
+     */
+    getServiceConfigs(): Record<string, MCPServiceConfig>;
+    /**
+     * 启动所有服务
+     */
+    startAllServices(): Promise<void>;
+    /**
+     * 启动单个服务
+     */
+    startService(serviceName: string): Promise<void>;
+    /**
+     * 获取所有工具列表
+     */
+    getAllTools(status?: ToolStatusFilter): EnhancedToolInfo[];
+    /**
+     * 调用工具
+     */
+    callTool(toolName: string, _arguments_: Record<string, unknown>, _options?: {
+        timeout?: number;
+    }): Promise<ToolCallResult>;
+    /**
+     * 添加工具（用于测试或自定义工具）
+     */
+    addTool(tool: EnhancedToolInfo): void;
+    /**
+     * 移除工具
+     */
+    removeTool(toolName: string): void;
+    /**
+     * 获取管理器状态
+     */
+    getStatus(): ManagerStatus;
+    /**
+     * 清理资源
+     */
+    cleanup(): Promise<void>;
+}
+
+export { ConnectionState, type CustomMCPTool, type EnhancedToolInfo, type JSONSchema, type MCPServiceConfig, type MCPServiceConnectionStatus, MCPServiceManager, type MCPServiceStatus, MCPTransportType, type ManagerStatus, type ModelScopeSSEOptions, ToolCallError, ToolCallErrorCode, type ToolCallParams, type ToolCallResult, type ToolCallValidationOptions, type ToolInfo, type UnifiedServerConfig, type UnifiedServerStatus, type ValidatedToolCallParams, ensureToolJSONSchema, isValidToolJSONSchema };

package/dist/index.js

@@ -0,0 +1,196 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/types.ts
+var MCPTransportType = /* @__PURE__ */ ((MCPTransportType2) => {
+  MCPTransportType2["STDIO"] = "stdio";
+  MCPTransportType2["SSE"] = "sse";
+  MCPTransportType2["STREAMABLE_HTTP"] = "streamable-http";
+  return MCPTransportType2;
+})(MCPTransportType || {});
+var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
+  ConnectionState2["DISCONNECTED"] = "disconnected";
+  ConnectionState2["CONNECTING"] = "connecting";
+  ConnectionState2["CONNECTED"] = "connected";
+  ConnectionState2["RECONNECTING"] = "reconnecting";
+  ConnectionState2["FAILED"] = "failed";
+  ConnectionState2["ERROR"] = "error";
+  return ConnectionState2;
+})(ConnectionState || {});
+function isValidToolJSONSchema(obj) {
+  return typeof obj === "object" && obj !== null && "type" in obj && obj.type === "object";
+}
+__name(isValidToolJSONSchema, "isValidToolJSONSchema");
+function ensureToolJSONSchema(schema) {
+  if (isValidToolJSONSchema(schema)) {
+    return schema;
+  }
+  return {
+    type: "object",
+    properties: {},
+    required: [],
+    additionalProperties: true
+  };
+}
+__name(ensureToolJSONSchema, "ensureToolJSONSchema");
+var ToolCallErrorCode = /* @__PURE__ */ ((ToolCallErrorCode2) => {
+  ToolCallErrorCode2[ToolCallErrorCode2["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+  ToolCallErrorCode2[ToolCallErrorCode2["TOOL_NOT_FOUND"] = -32601] = "TOOL_NOT_FOUND";
+  ToolCallErrorCode2[ToolCallErrorCode2["SERVICE_UNAVAILABLE"] = -32001] = "SERVICE_UNAVAILABLE";
+  ToolCallErrorCode2[ToolCallErrorCode2["TIMEOUT"] = -32002] = "TIMEOUT";
+  ToolCallErrorCode2[ToolCallErrorCode2["TOOL_EXECUTION_ERROR"] = -32e3] = "TOOL_EXECUTION_ERROR";
+  return ToolCallErrorCode2;
+})(ToolCallErrorCode || {});
+var ToolCallError = class extends Error {
+  constructor(code, message, data) {
+    super(message);
+    this.code = code;
+    this.data = data;
+    this.name = "ToolCallError";
+  }
+  static {
+    __name(this, "ToolCallError");
+  }
+};
+
+// src/manager.ts
+import { EventEmitter } from "events";
+var MCPServiceManager = class extends EventEmitter {
+  static {
+    __name(this, "MCPServiceManager");
+  }
+  configs = {};
+  tools = /* @__PURE__ */ new Map();
+  isInitialized = false;
+  constructor(configs) {
+    super();
+    if (configs) {
+      this.configs = configs;
+    }
+  }
+  /**
+   * 添加服务配置
+   */
+  addServiceConfig(name, config) {
+    this.configs[name] = { ...config, name };
+  }
+  /**
+   * 更新服务配置
+   */
+  updateServiceConfig(name, config) {
+    if (!this.configs[name]) {
+      throw new Error(`\u670D\u52A1\u4E0D\u5B58\u5728: ${name}`);
+    }
+    this.configs[name] = { ...config, name };
+  }
+  /**
+   * 移除服务配置
+   */
+  removeServiceConfig(name) {
+    delete this.configs[name];
+  }
+  /**
+   * 获取所有服务配置
+   */
+  getServiceConfigs() {
+    return { ...this.configs };
+  }
+  /**
+   * 启动所有服务
+   */
+  async startAllServices() {
+    if (this.isInitialized) {
+      return;
+    }
+    this.isInitialized = true;
+    this.emit("initialized");
+  }
+  /**
+   * 启动单个服务
+   */
+  async startService(serviceName) {
+    if (!this.configs[serviceName]) {
+      throw new Error(`\u670D\u52A1\u914D\u7F6E\u4E0D\u5B58\u5728: ${serviceName}`);
+    }
+    this.emit("serviceStarted", serviceName);
+  }
+  /**
+   * 获取所有工具列表
+   */
+  getAllTools(status = "all") {
+    const allTools = Array.from(this.tools.values());
+    if (status === "all") {
+      return allTools;
+    }
+    return allTools.filter(
+      (tool) => status === "enabled" ? tool.enabled : !tool.enabled
+    );
+  }
+  /**
+   * 调用工具
+   */
+  async callTool(toolName, _arguments_, _options) {
+    const tool = this.tools.get(toolName);
+    if (!tool) {
+      throw new ToolCallError(
+        -32601 /* TOOL_NOT_FOUND */,
+        `\u5DE5\u5177\u4E0D\u5B58\u5728: ${toolName}`
+      );
+    }
+    if (!tool.enabled) {
+      throw new ToolCallError(
+        -32001 /* SERVICE_UNAVAILABLE */,
+        `\u5DE5\u5177\u5DF2\u7981\u7528: ${toolName}`
+      );
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `\u5DE5\u5177 ${toolName} \u9700\u8981\u901A\u8FC7\u5B9E\u9645\u7684 MCP \u8FDE\u63A5\u8C03\u7528`
+        }
+      ],
+      isError: false
+    };
+  }
+  /**
+   * 添加工具（用于测试或自定义工具）
+   */
+  addTool(tool) {
+    this.tools.set(tool.name, tool);
+  }
+  /**
+   * 移除工具
+   */
+  removeTool(toolName) {
+    this.tools.delete(toolName);
+  }
+  /**
+   * 获取管理器状态
+   */
+  getStatus() {
+    const availableTools = this.getAllTools("enabled").map((t) => t.name);
+    return {
+      services: {},
+      totalTools: this.tools.size,
+      availableTools
+    };
+  }
+  /**
+   * 清理资源
+   */
+  async cleanup() {
+    this.tools.clear();
+    this.isInitialized = false;
+  }
+};
+export {
+  ConnectionState,
+  MCPServiceManager,
+  MCPTransportType,
+  ToolCallError,
+  ToolCallErrorCode,
+  ensureToolJSONSchema,
+  isValidToolJSONSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/manager.ts"],"sourcesContent":["/**\n * MCP 核心库类型定义\n * 统一管理所有 MCP 相关的类型定义\n */\n\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\n\n// =========================\n// 1. 基础传输类型\n// =========================\n\n/**\n * 通信方式枚举\n * 定义 MCP 支持的传输类型\n */\nexport enum MCPTransportType {\n  STDIO = \"stdio\",\n  SSE = \"sse\",\n  STREAMABLE_HTTP = \"streamable-http\",\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","/**\n * 简化版 MCP 服务管理器\n * 专门为 endpoint 包设计，提供核心 MCP 服务管理功能\n */\n\nimport { EventEmitter } from \"node:events\";\nimport type {\n  EnhancedToolInfo,\n  MCPServiceConfig,\n  ManagerStatus,\n  ToolCallResult,\n  ToolStatusFilter,\n} from \"./types.js\";\nimport { ToolCallError, ToolCallErrorCode } from \"./types.js\";\n\n/**\n * 简化版 MCP 服务管理器\n * 提供 MCP 服务的核心管理功能\n */\nexport class MCPServiceManager extends EventEmitter {\n  private configs: Record<string, MCPServiceConfig> = {};\n  private tools: Map<string, EnhancedToolInfo> = new Map();\n  private isInitialized = false;\n\n  constructor(configs?: Record<string, MCPServiceConfig>) {\n    super();\n    if (configs) {\n      this.configs = configs;\n    }\n  }\n\n  /**\n   * 添加服务配置\n   */\n  addServiceConfig(name: string, config: MCPServiceConfig): void {\n    this.configs[name] = { ...config, name };\n  }\n\n  /**\n   * 更新服务配置\n   */\n  updateServiceConfig(name: string, config: MCPServiceConfig): void {\n    if (!this.configs[name]) {\n      throw new Error(`服务不存在: ${name}`);\n    }\n    this.configs[name] = { ...config, name };\n  }\n\n  /**\n   * 移除服务配置\n   */\n  removeServiceConfig(name: string): void {\n    delete this.configs[name];\n  }\n\n  /**\n   * 获取所有服务配置\n   */\n  getServiceConfigs(): Record<string, MCPServiceConfig> {\n    return { ...this.configs };\n  }\n\n  /**\n   * 启动所有服务\n   */\n  async startAllServices(): Promise<void> {\n    if (this.isInitialized) {\n      return;\n    }\n\n    // 这里应该创建实际的 MCP 服务连接\n    // 由于 endpoint 包需要独立发布，我们暂时提供一个基础实现\n    this.isInitialized = true;\n\n    this.emit(\"initialized\");\n  }\n\n  /**\n   * 启动单个服务\n   */\n  async startService(serviceName: string): Promise<void> {\n    if (!this.configs[serviceName]) {\n      throw new Error(`服务配置不存在: ${serviceName}`);\n    }\n\n    // 这里应该创建实际的 MCP 服务连接\n    this.emit(\"serviceStarted\", serviceName);\n  }\n\n  /**\n   * 获取所有工具列表\n   */\n  getAllTools(status: ToolStatusFilter = \"all\"): EnhancedToolInfo[] {\n    const allTools = Array.from(this.tools.values());\n\n    if (status === \"all\") {\n      return allTools;\n    }\n\n    return allTools.filter((tool) =>\n      status === \"enabled\" ? tool.enabled : !tool.enabled\n    );\n  }\n\n  /**\n   * 调用工具\n   */\n  async callTool(\n    toolName: string,\n    _arguments_: Record<string, unknown>,\n    _options?: { timeout?: number }\n  ): Promise<ToolCallResult> {\n    const tool = this.tools.get(toolName);\n\n    if (!tool) {\n      throw new ToolCallError(\n        ToolCallErrorCode.TOOL_NOT_FOUND,\n        `工具不存在: ${toolName}`\n      );\n    }\n\n    if (!tool.enabled) {\n      throw new ToolCallError(\n        ToolCallErrorCode.SERVICE_UNAVAILABLE,\n        `工具已禁用: ${toolName}`\n      );\n    }\n\n    // 这里应该调用实际的 MCP 工具\n    // 由于这是一个简化实现，我们返回一个占位结果\n    return {\n      content: [\n        {\n          type: \"text\",\n          text: `工具 ${toolName} 需要通过实际的 MCP 连接调用`,\n        },\n      ],\n      isError: false,\n    };\n  }\n\n  /**\n   * 添加工具（用于测试或自定义工具）\n   */\n  addTool(tool: EnhancedToolInfo): void {\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * 移除工具\n   */\n  removeTool(toolName: string): void {\n    this.tools.delete(toolName);\n  }\n\n  /**\n   * 获取管理器状态\n   */\n  getStatus(): ManagerStatus {\n    const availableTools = this.getAllTools(\"enabled\").map((t) => t.name);\n\n    return {\n      services: {},\n      totalTools: this.tools.size,\n      availableTools,\n    };\n  }\n\n  /**\n   * 清理资源\n   */\n  async cleanup(): Promise<void> {\n    this.tools.clear();\n    this.isInitialized = false;\n  }\n}\n"],"mappings":"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","names":["MCPTransportType","ConnectionState","ToolCallErrorCode"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@xiaozhi-client/mcp-core",
+  "version": "1.9.7-beta.3",
+  "description": "MCP 协议核心实现，提供服务管理和连接功能",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ws": "^8.14.2"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "@types/ws": "^8.5.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "xiaozhi",
+    "mcp",
+    "model-context-protocol",
+    "service-manager"
+  ],
+  "author": "xiaozhi-client",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "type-check": "tsc --noEmit"
+  }
+}