@univerjs-pro/mcp 0.10.9 → 0.10.10-experimental.20251010-3f807c5

package/lib/types/controllers/config.schema.d.ts

@@ -15,7 +15,7 @@ export declare enum MCPConnectionStatus {
  */
 export declare enum MCPConnectionError {
     NONE = "NONE",
-    INVALID_API_KEY = "INVALID_API_KEY",
+    UNAUTHORIZED = "UNAUTHORIZED",
     SESSION_ID_OCCUPIED = "SESSION_ID_OCCUPIED",
     NETWORK_ERROR = "NETWORK_ERROR",
     MAX_RETRIES_EXCEEDED = "MAX_RETRIES_EXCEEDED"

package/lib/types/controllers/mcp-connection.controller.d.ts

@@ -1,6 +1,6 @@
 import { Disposable, IConfigService, ILogService, Injector } from '@univerjs/core';
 import { HTTPService } from '@univerjs/network';
-import { MCPUIEventService } from '../services/mcp-ui-event.service';
+import { MCPEventService } from '../services/mcp-event.service';
 import { MCPConnectionError, MCPConnectionStatus } from './config.schema';
 /**
  * MCP WebSocket Message interface
@@ -31,7 +31,7 @@ export declare class MCPConnectionController extends Disposable {
     private readonly _configService;
     private readonly _logService;
     private readonly _httpService;
-    private readonly _mcpUIEventService;
+    private readonly _mcpEventService;
     private _socket;
     private _retryCount;
     private _connectionStatus;
@@ -46,7 +46,7 @@ export declare class MCPConnectionController extends Disposable {
     readonly sessionId$: import('rxjs').Observable<string>;
     private readonly _message$;
     readonly message$: import('rxjs').Observable<IMCPMessage>;
-    constructor(_injector: Injector, _configService: IConfigService, _logService: ILogService, _httpService: HTTPService, _mcpUIEventService: MCPUIEventService);
+    constructor(_injector: Injector, _configService: IConfigService, _logService: ILogService, _httpService: HTTPService, _mcpEventService: MCPEventService);
     /**
      * Get current connection status
      */
@@ -111,11 +111,11 @@ export declare class MCPConnectionController extends Disposable {
      */
     private _scheduleReconnect;
     /**
-     * Set connection status and emit UI event
+     * Set connection status
      */
     private _setConnectionStatus;
     /**
-     * Set connection error and emit UI event
+     * Set connection error
      */
     private _setConnectionError;
     /**

package/lib/types/controllers/mcp-tool-registry.controller.d.ts

@@ -1,6 +1,6 @@
 import { Disposable, ILogService } from '@univerjs/core';
 import { z } from 'zod';
-import { MCPUIEventService } from '../services/mcp-ui-event.service';
+import { MCPEventService } from '../services/mcp-event.service';
 /**
  * MCP Tool definition interface
  */
@@ -37,9 +37,9 @@ export declare const IMCPToolRegistry: import('@wendellhu/redi').IdentifierDecor
  */
 export declare class MCPToolRegistryController extends Disposable implements IMCPToolRegistry {
     private readonly _logService;
-    private readonly _mcpUIEventService;
+    private readonly _mcpEventService;
     private readonly _tools;
-    constructor(_logService: ILogService, _mcpUIEventService: MCPUIEventService);
+    constructor(_logService: ILogService, _mcpEventService: MCPEventService);
     /**
      * Register a tool for MCP calls
      */

package/lib/types/facade/f-event.d.ts

@@ -0,0 +1,150 @@
+import { MCPConnectionError, MCPConnectionStatus, MCPEventId } from '@univerjs-pro/mcp';
+import { IEventBase } from '@univerjs/core/facade';
+/**
+ * Event triggered when MCP connection status changes
+ */
+export interface IMcpConnectionStatusChangedEvent extends IEventBase {
+    /**
+     * Connection status
+     */
+    status: MCPConnectionStatus;
+    /**
+     * Connection error (if any)
+     */
+    error?: MCPConnectionError;
+    /**
+     * Status message
+     */
+    message?: string;
+}
+/**
+ * Event triggered when MCP tool call is received
+ */
+export interface IMcpToolCallReceivedEvent extends IEventBase {
+    /**
+     * The name of the tool being called
+     */
+    toolName: string;
+    /**
+     * The parameters passed to the tool
+     */
+    parameters: unknown;
+    /**
+     * The tool call ID (for tracking)
+     */
+    callId?: string;
+}
+/**
+ * Event triggered when MCP tool call executes successfully
+ */
+export interface IMcpToolCallExecutedEvent extends IEventBase {
+    /**
+     * The name of the tool that was called
+     */
+    toolName: string;
+    /**
+     * The tool call ID (for tracking)
+     */
+    callId?: string;
+    /**
+     * The result returned by the tool
+     */
+    result?: unknown;
+}
+/**
+ * Event triggered when MCP tool call fails
+ */
+export interface IMcpToolCallFailedEvent extends IEventBase {
+    /**
+     * The name of the tool that failed
+     */
+    toolName: string;
+    /**
+     * The tool call ID (for tracking)
+     */
+    callId?: string;
+    /**
+     * The error that occurred
+     */
+    error?: string;
+}
+/**
+ * Constants for MCP event names
+ * @ignore
+ * @example
+ * ```typescript
+ * // Subscribe to connection status changes
+ * univerAPI.addEvent(univerAPI.Event.McpConnectionStatusChanged, (event) => {
+ *   console.log('Connection status:', event.status);
+ * });
+ *
+ * // Subscribe to tool call events
+ * univerAPI.addEvent(univerAPI.Event.McpToolCallReceived, (event) => {
+ *   console.log('Tool called:', event.toolName);
+ * });
+ * ```
+ */
+export interface IFMCPEventName {
+    /**
+     * Event triggered when MCP connection status changes
+     * @see {@link IMcpConnectionStatusChangedEvent}
+     * @example
+     * ```typescript
+     * univerAPI.addEvent(univerAPI.Event.McpConnectionStatusChanged, (event) => {
+     *   if (event.status === 'CONNECTED') {
+     *     console.log('MCP server connected');
+     *   }
+     * });
+     * ```
+     */
+    readonly McpConnectionStatusChanged: typeof MCPEventId.McpConnectionStatusChanged;
+    /**
+     * Event triggered when MCP tool call is received
+     * @see {@link IMcpToolCallReceivedEvent}
+     * @example
+     * ```typescript
+     * univerAPI.addEvent(univerAPI.Event.McpToolCallReceived, (event) => {
+     *   console.log(`Received tool call: ${event.toolName}`, event.parameters);
+     * });
+     * ```
+     */
+    readonly McpToolCallReceived: typeof MCPEventId.McpToolCallReceived;
+    /**
+     * Event triggered when MCP tool call executes successfully
+     * @see {@link IMcpToolCallExecutedEvent}
+     * @example
+     * ```typescript
+     * univerAPI.addEvent(univerAPI.Event.McpToolCallExecuted, (event) => {
+     *   console.log(`Tool ${event.toolName} executed successfully:`, event.result);
+     * });
+     * ```
+     */
+    readonly McpToolCallExecuted: typeof MCPEventId.McpToolCallExecuted;
+    /**
+     * Event triggered when MCP tool call fails
+     * @see {@link IMcpToolCallFailedEvent}
+     * @example
+     * ```typescript
+     * univerAPI.addEvent(univerAPI.Event.McpToolCallFailed, (event) => {
+     *   console.error(`Tool ${event.toolName} failed:`, event.error);
+     * });
+     * ```
+     */
+    readonly McpToolCallFailed: typeof MCPEventId.McpToolCallFailed;
+}
+/**
+ * Event configuration for MCP events
+ * @ignore
+ */
+export interface IMCPEventConfig {
+    McpConnectionStatusChanged: IMcpConnectionStatusChangedEvent;
+    McpToolCallReceived: IMcpToolCallReceivedEvent;
+    McpToolCallExecuted: IMcpToolCallExecutedEvent;
+    McpToolCallFailed: IMcpToolCallFailedEvent;
+}
+declare module '@univerjs/core/facade' {
+    interface FEventName extends IFMCPEventName {
+    }
+    interface IEventParamConfig extends IMCPEventConfig {
+    }
+}

package/lib/types/facade/f-univer.d.ts

@@ -1,4 +1,5 @@
 import { IMCPTool } from '@univerjs-pro/mcp';
+import { Injector } from '@univerjs/core';
 import { FUniver } from '@univerjs/core/facade';
 /**
  * @ignore
@@ -24,8 +25,22 @@ interface IFUniverMCP {
      * @param params The parameters for the tool.
      */
     callMCPTool(toolName: string, params: unknown): Promise<any>;
+    /**
+     * Get current MCP connection status.
+     */
+    getMCPConnectionStatus(): string;
+    /**
+     * Connect to MCP server.
+     */
+    connectMCP(): void;
+    /**
+     * Disconnect from MCP server.
+     */
+    disconnectMCP(): void;
 }
 export declare class FUniverMCPMixin extends FUniver implements IFUniverMCP {
+    _initialize(injector: Injector): void;
+    private _registerMCPFacadeEvents;
     validateMCPToolCall(toolName: string, params: unknown): {
         isValid: boolean;
         error?: string;
@@ -33,6 +48,9 @@ export declare class FUniverMCPMixin extends FUniver implements IFUniverMCP {
     };
     getAllMCPTools(): IMCPTool[];
     callMCPTool(toolName: string, params: unknown): Promise<any>;
+    getMCPConnectionStatus(): string;
+    connectMCP(): void;
+    disconnectMCP(): void;
 }
 declare module '@univerjs/core/facade' {
     interface FUniver extends IFUniverMCP {

package/lib/types/facade/index.d.ts

@@ -1 +1,3 @@
+import './f-event';
 import './f-univer';
+export type { IMcpConnectionStatusChangedEvent, IMcpToolCallExecutedEvent, IMcpToolCallFailedEvent, IMcpToolCallReceivedEvent, } from './f-event';

package/lib/types/index.d.ts

@@ -4,4 +4,5 @@ export { MCPConnectionController } from './controllers/mcp-connection.controller
 export { MCPMessageController } from './controllers/mcp-message.controller';
 export { type IMCPTool, IMCPToolRegistry, MCPToolRegistryController } from './controllers/mcp-tool-registry.controller';
 export { UniverMCPPlugin } from './plugin';
-export { type IConfigUpdateEvent, type IConnectionStatusEvent, type IMCPUIEvent, type IToolCallEvent, type IToolExecutionEvent, MCPUIEventId, MCPUIEventService } from './services/mcp-ui-event.service';
+export { MCPEventId } from './services/mcp-event.service';
+export { MCPEventService } from './services/mcp-event.service';

package/lib/types/services/mcp-event.service.d.ts

@@ -0,0 +1,86 @@
+import { MCPConnectionError, MCPConnectionStatus } from '../controllers/config.schema';
+/**
+ * MCP event interface - unified for all event types with strong typing
+ */
+export type IMCPEvent = {
+    type: MCPEventId.McpConnectionStatusChanged;
+    data: IConnectionStatusEvent;
+} | {
+    type: MCPEventId.McpToolCallReceived;
+    data: IToolCallEvent;
+} | {
+    type: MCPEventId.McpToolCallExecuted;
+    data: IToolExecutionEvent;
+} | {
+    type: MCPEventId.McpToolCallFailed;
+    data: IToolExecutionEvent;
+};
+/**
+ * MCP event IDs for communication between MCP core and consumers
+ */
+export declare enum MCPEventId {
+    McpConnectionStatusChanged = "McpConnectionStatusChanged",
+    McpToolCallReceived = "McpToolCallReceived",
+    McpToolCallExecuted = "McpToolCallExecuted",
+    McpToolCallFailed = "McpToolCallFailed"
+}
+/**
+ * Connection status change event data
+ */
+export interface IConnectionStatusEvent {
+    status: MCPConnectionStatus;
+    error?: MCPConnectionError;
+    message?: string;
+}
+/**
+ * Tool call event data
+ */
+export interface IToolCallEvent {
+    toolName: string;
+    parameters: unknown;
+    callId?: string;
+}
+/**
+ * Tool execution result event data
+ */
+export interface IToolExecutionEvent {
+    toolName: string;
+    callId?: string;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Configuration update event data
+ */
+export interface IConfigUpdateEvent {
+    key: string;
+    value: unknown;
+}
+/**
+ * MCP Event Service
+ *
+ * This service provides event communication for MCP system:
+ * - Between MCP core and MCP UI plugin
+ * - For direct subscription by non-facade users
+ * - As source for facade event forwarding
+ */
+export declare class MCPEventService {
+    private readonly _event$;
+    readonly event$: import('rxjs').Observable<IMCPEvent>;
+    /**
+     * Emit an MCP event (private - use specific emit methods for type safety)
+     */
+    private emitEvent;
+    /**
+     * Emit connection status change event
+     */
+    _emitConnectionStatus(event: IConnectionStatusEvent): void;
+    /**
+     * Emit tool call received event
+     */
+    _emitToolCallReceived(event: IToolCallEvent): void;
+    /**
+     * Emit tool execution result event
+     */
+    _emitToolExecuted(event: IToolExecutionEvent): void;
+}

package/lib/umd/facade.js

@@ -1 +1 @@
-(function(_0x1c1f60,_0x1b4bde){var _0x564a91=_0x50f1,_0x25dc2e=_0x1c1f60();while(!![]){try{var _0x253111=-parseInt(_0x564a91(0xf7))/0x1*(parseInt(_0x564a91(0x101))/0x2)+-parseInt(_0x564a91(0x104))/0x3+parseInt(_0x564a91(0xf4))/0x4+parseInt(_0x564a91(0xf5))/0x5*(-parseInt(_0x564a91(0x107))/0x6)+parseInt(_0x564a91(0x100))/0x7*(parseInt(_0x564a91(0xf6))/0x8)+-parseInt(_0x564a91(0xfa))/0x9+-parseInt(_0x564a91(0x108))/0xa*(-parseInt(_0x564a91(0xfe))/0xb);if(_0x253111===_0x1b4bde)break;else _0x25dc2e['push'](_0x25dc2e['shift']());}catch(_0x55883b){_0x25dc2e['push'](_0x25dc2e['shift']());}}}(_0x1257,0x69189),function(_0x4992e3,_0x24d8a8){var _0x550b88=_0x50f1;typeof exports=='object'&&typeof module<'u'?_0x24d8a8(require('@univerjs-pro/mcp'),require('@univerjs/core/facade')):typeof define=='function'&&define['amd']?define([_0x550b88(0x106),_0x550b88(0xf8)],_0x24d8a8):(_0x4992e3=typeof globalThis<'u'?globalThis:_0x4992e3||self,_0x24d8a8(_0x4992e3[_0x550b88(0xfc)],_0x4992e3['UniverCoreFacade']));}(this,function(_0x2b1e0f,_0x2aabea){'use strict';var _0xab68fd=_0x50f1;class _0x12cc5c extends _0x2aabea[_0xab68fd(0x103)]{['validateMCPToolCall'](_0x4065c3,_0x4949b0){var _0x476033=_0xab68fd;return this['_injector'][_0x476033(0x102)](_0x2b1e0f['IMCPToolRegistry'])['validateToolCall'](_0x4065c3,_0x4949b0);}[_0xab68fd(0xfd)](){var _0x21791d=_0xab68fd;return this[_0x21791d(0x10a)][_0x21791d(0x102)](_0x2b1e0f[_0x21791d(0xf9)])[_0x21791d(0x105)]();}[_0xab68fd(0xff)](_0x2d7040,_0x4f4d40){var _0x3488f2=_0xab68fd;return this[_0x3488f2(0x10a)][_0x3488f2(0x102)](_0x2b1e0f[_0x3488f2(0xf9)])[_0x3488f2(0x109)](_0x2d7040,_0x4f4d40);}}_0x2aabea[_0xab68fd(0x103)][_0xab68fd(0xfb)](_0x12cc5c);}));function _0x50f1(_0x2c4e50,_0x2df409){var _0x125723=_0x1257();return _0x50f1=function(_0x50f182,_0x18fa3a){_0x50f182=_0x50f182-0xf4;var _0x1c2353=_0x125723[_0x50f182];return _0x1c2353;},_0x50f1(_0x2c4e50,_0x2df409);}function _0x1257(){var _0x45a7ab=['2971368tRlUAv','extend','UniverProMcp','getAllMCPTools','15817681FMbrsm','callMCPTool','49PhebdQ','74jtrlDt','get','FUniver','724116JUqHHZ','getAllTools','@univerjs-pro/mcp','630qoNVDU','10kqIehK','executeTool','_injector','28148ShKjze','25825lxaAMV','622072hJSChv','12027kOxyfr','@univerjs/core/facade','IMCPToolRegistry'];_0x1257=function(){return _0x45a7ab;};return _0x1257();}
+function _0x192c(_0x45c74a,_0x9856a4){const _0x538cd3=_0x538c();return _0x192c=function(_0x192cbf,_0x16a408){_0x192cbf=_0x192cbf-0x15f;let _0x2ea084=_0x538cd3[_0x192cbf];return _0x2ea084;},_0x192c(_0x45c74a,_0x9856a4);}(function(_0x542474,_0x1c0c13){const _0x22e37d=_0x192c,_0x1a606a=_0x542474();while(!![]){try{const _0xbb0856=-parseInt(_0x22e37d(0x168))/0x1+parseInt(_0x22e37d(0x183))/0x2+parseInt(_0x22e37d(0x178))/0x3*(parseInt(_0x22e37d(0x160))/0x4)+-parseInt(_0x22e37d(0x181))/0x5+-parseInt(_0x22e37d(0x17e))/0x6*(-parseInt(_0x22e37d(0x172))/0x7)+parseInt(_0x22e37d(0x17f))/0x8+-parseInt(_0x22e37d(0x185))/0x9*(parseInt(_0x22e37d(0x16b))/0xa);if(_0xbb0856===_0x1c0c13)break;else _0x1a606a['push'](_0x1a606a['shift']());}catch(_0x579476){_0x1a606a['push'](_0x1a606a['shift']());}}}(_0x538c,0x66fa9),function(_0x80edec,_0x432864){const _0xbed0fe=_0x192c;typeof exports==_0xbed0fe(0x17a)&&typeof module<'u'?_0x432864(require('@univerjs-pro/mcp'),require('@univerjs/core/facade'),require('@univerjs/core')):typeof define==_0xbed0fe(0x167)&&define[_0xbed0fe(0x177)]?define([_0xbed0fe(0x15f),_0xbed0fe(0x163),_0xbed0fe(0x161)],_0x432864):(_0x80edec=typeof globalThis<'u'?globalThis:_0x80edec||self,_0x432864(_0x80edec[_0xbed0fe(0x17c)],_0x80edec['UniverCoreFacade'],_0x80edec[_0xbed0fe(0x18a)]));}(this,function(_0x515741,_0x485c58,_0x4de0f2){'use strict';const _0x24b061=_0x192c;class _0x171ed0{get['McpConnectionStatusChanged'](){const _0x281b65=_0x192c;return _0x515741['MCPEventId'][_0x281b65(0x16f)];}get[_0x24b061(0x184)](){const _0x5a3dc8=_0x24b061;return _0x515741[_0x5a3dc8(0x165)][_0x5a3dc8(0x184)];}get['McpToolCallExecuted'](){const _0x4df152=_0x24b061;return _0x515741[_0x4df152(0x165)][_0x4df152(0x173)];}get[_0x24b061(0x176)](){const _0x3aa08d=_0x24b061;return _0x515741[_0x3aa08d(0x165)][_0x3aa08d(0x176)];}}_0x485c58[_0x24b061(0x16c)][_0x24b061(0x189)](_0x171ed0);class _0x335304 extends _0x485c58[_0x24b061(0x16a)]{['_initialize'](_0x3b9f3e){const _0x1715a6=_0x24b061;this[_0x1715a6(0x171)](_0x3b9f3e);}[_0x24b061(0x171)](_0x54b8e7){const _0xc36550=_0x24b061,_0x56f5e8=_0x54b8e7['get'](_0x515741[_0xc36550(0x162)]);this[_0xc36550(0x174)](this[_0xc36550(0x17b)][_0xc36550(0x16f)],()=>_0x4de0f2[_0xc36550(0x188)](_0x56f5e8[_0xc36550(0x175)][_0xc36550(0x187)](_0x23fff9=>{const _0x20f144=_0xc36550;_0x23fff9['type']===_0x515741[_0x20f144(0x165)][_0x20f144(0x16f)]&&this[_0x20f144(0x18d)](this[_0x20f144(0x17b)][_0x20f144(0x16f)],_0x23fff9[_0x20f144(0x186)]);}))),this[_0xc36550(0x174)](this[_0xc36550(0x17b)][_0xc36550(0x184)],()=>_0x4de0f2[_0xc36550(0x188)](_0x56f5e8[_0xc36550(0x175)][_0xc36550(0x187)](_0x1a7062=>{const _0x113073=_0xc36550;_0x1a7062[_0x113073(0x166)]===_0x515741[_0x113073(0x165)][_0x113073(0x184)]&&this[_0x113073(0x18d)](this[_0x113073(0x17b)][_0x113073(0x184)],_0x1a7062[_0x113073(0x186)]);}))),this[_0xc36550(0x174)](this[_0xc36550(0x17b)][_0xc36550(0x173)],()=>_0x4de0f2[_0xc36550(0x188)](_0x56f5e8[_0xc36550(0x175)][_0xc36550(0x187)](_0x3b50e1=>{const _0x66ca2c=_0xc36550;_0x3b50e1['type']===_0x515741[_0x66ca2c(0x165)]['McpToolCallExecuted']&&this[_0x66ca2c(0x18d)](this[_0x66ca2c(0x17b)]['McpToolCallExecuted'],_0x3b50e1[_0x66ca2c(0x186)]);}))),this[_0xc36550(0x174)](this[_0xc36550(0x17b)][_0xc36550(0x176)],()=>_0x4de0f2[_0xc36550(0x188)](_0x56f5e8[_0xc36550(0x175)]['subscribe'](_0x42073f=>{const _0x4f1e37=_0xc36550;_0x42073f[_0x4f1e37(0x166)]===_0x515741[_0x4f1e37(0x165)][_0x4f1e37(0x176)]&&this[_0x4f1e37(0x18d)](this[_0x4f1e37(0x17b)][_0x4f1e37(0x176)],_0x42073f[_0x4f1e37(0x186)]);})));}[_0x24b061(0x179)](_0x2c1913,_0x4f7d8c){const _0x14a065=_0x24b061;return this[_0x14a065(0x170)][_0x14a065(0x18b)](_0x515741['IMCPToolRegistry'])[_0x14a065(0x169)](_0x2c1913,_0x4f7d8c);}['getAllMCPTools'](){const _0x24068e=_0x24b061;return this['_injector']['get'](_0x515741[_0x24068e(0x18c)])['getAllTools']();}[_0x24b061(0x164)](_0x36104d,_0x189774){const _0x1f6c21=_0x24b061;return this[_0x1f6c21(0x170)][_0x1f6c21(0x18b)](_0x515741[_0x1f6c21(0x18c)])['executeTool'](_0x36104d,_0x189774);}[_0x24b061(0x16e)](){const _0x4ce0f6=_0x24b061;return this['_injector'][_0x4ce0f6(0x18b)](_0x515741[_0x4ce0f6(0x17d)])['getConnectionStatus']();}[_0x24b061(0x16d)](){const _0x3e4949=_0x24b061;this[_0x3e4949(0x170)][_0x3e4949(0x18b)](_0x515741[_0x3e4949(0x17d)])[_0x3e4949(0x180)]();}[_0x24b061(0x182)](){const _0x19a626=_0x24b061;this[_0x19a626(0x170)][_0x19a626(0x18b)](_0x515741[_0x19a626(0x17d)])['disconnect']();}}_0x485c58[_0x24b061(0x16a)][_0x24b061(0x189)](_0x335304);}));function _0x538c(){const _0x134bf5=['validateMCPToolCall','object','Event','UniverProMcp','MCPConnectionController','6yftjHw','4399640qgWLQo','connect','1705115UDCCfA','disconnectMCP','1424076anQHTK','McpToolCallReceived','8841060SJrKdw','data','subscribe','toDisposable','extend','UniverCore','get','IMCPToolRegistry','fireEvent','@univerjs-pro/mcp','4ebrMEq','@univerjs/core','MCPEventService','@univerjs/core/facade','callMCPTool','MCPEventId','type','function','538005XpmEEb','validateToolCall','FUniver','10jSupHk','FEventName','connectMCP','getMCPConnectionStatus','McpConnectionStatusChanged','_injector','_registerMCPFacadeEvents','3483011LWlneg','McpToolCallExecuted','registerEventHandler','event$','McpToolCallFailed','amd','1570809QKXmbO'];_0x538c=function(){return _0x134bf5;};return _0x538c();}