@univerjs-pro/mcp 0.10.8 → 0.10.9-nightly.202509260614

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 _0x3574(_0x21c890,_0x118a0c){var _0x3e1a15=_0x3e1a();return _0x3574=function(_0x357486,_0x1f648d){_0x357486=_0x357486-0x13b;var _0x36af00=_0x3e1a15[_0x357486];return _0x36af00;},_0x3574(_0x21c890,_0x118a0c);}function _0x3e1a(){var _0x388eb9=['extend','amd','3039048xkoamD','5696404lNLCSO','validateToolCall','2651230uquYNl','getAllMCPTools','1752960BtmxNu','6vMKEvF','2218NOHXEm','2793200ygtBQS','executeTool','15182955agZqqb','callMCPTool','@univerjs/core/facade','FUniver','object','UniverProMcp','getAllTools','@univerjs-pro/mcp','1DQxcKr','_injector','function','get','UniverCoreFacade'];_0x3e1a=function(){return _0x388eb9;};return _0x3e1a();}(function(_0x59e762,_0x464325){var _0x544892=_0x3574,_0x46ee43=_0x59e762();while(!![]){try{var _0x3dc82a=parseInt(_0x544892(0x140))/0x1*(-parseInt(_0x544892(0x14e))/0x2)+-parseInt(_0x544892(0x14c))/0x3+-parseInt(_0x544892(0x14f))/0x4+parseInt(_0x544892(0x14a))/0x5+parseInt(_0x544892(0x14d))/0x6*(-parseInt(_0x544892(0x148))/0x7)+parseInt(_0x544892(0x147))/0x8+parseInt(_0x544892(0x151))/0x9;if(_0x3dc82a===_0x464325)break;else _0x46ee43['push'](_0x46ee43['shift']());}catch(_0x177597){_0x46ee43['push'](_0x46ee43['shift']());}}}(_0x3e1a,0x79fa5),function(_0x3994d5,_0x5345d1){var _0x49adbb=_0x3574;typeof exports==_0x49adbb(0x13c)&&typeof module<'u'?_0x5345d1(require('@univerjs-pro/mcp'),require('@univerjs/core/facade')):typeof define==_0x49adbb(0x142)&&define[_0x49adbb(0x146)]?define([_0x49adbb(0x13f),_0x49adbb(0x153)],_0x5345d1):(_0x3994d5=typeof globalThis<'u'?globalThis:_0x3994d5||self,_0x5345d1(_0x3994d5[_0x49adbb(0x13d)],_0x3994d5[_0x49adbb(0x144)]));}(this,function(_0x53d04b,_0xb94797){'use strict';var _0x2fd051=_0x3574;class _0x58d208 extends _0xb94797[_0x2fd051(0x13b)]{['validateMCPToolCall'](_0x1cf6a1,_0x2bf038){var _0x265fe8=_0x2fd051;return this[_0x265fe8(0x141)][_0x265fe8(0x143)](_0x53d04b['IMCPToolRegistry'])[_0x265fe8(0x149)](_0x1cf6a1,_0x2bf038);}[_0x2fd051(0x14b)](){var _0x4440c1=_0x2fd051;return this[_0x4440c1(0x141)]['get'](_0x53d04b['IMCPToolRegistry'])[_0x4440c1(0x13e)]();}[_0x2fd051(0x152)](_0x15c76c,_0x13bb24){var _0x5e6382=_0x2fd051;return this[_0x5e6382(0x141)][_0x5e6382(0x143)](_0x53d04b['IMCPToolRegistry'])[_0x5e6382(0x150)](_0x15c76c,_0x13bb24);}}_0xb94797[_0x2fd051(0x13b)][_0x2fd051(0x145)](_0x58d208);}));
+function _0x1e07(){const _0x1f50ca=['toDisposable','event$','_injector','McpToolCallExecuted','extend','7466YtiZiW','UniverCoreFacade','@univerjs/core','16418208klxgAO','@univerjs/core/facade','MCPEventId','@univerjs-pro/mcp','data','McpConnectionStatusChanged','IMCPToolRegistry','7AlxeJn','786952CzdMFI','30NxsBmw','connect','validateToolCall','Event','MCPConnectionController','type','McpToolCallReceived','function','get','179oYLQmo','McpToolCallFailed','getAllTools','FEventName','subscribe','getConnectionStatus','fireEvent','MCPEventService','_registerMCPFacadeEvents','UniverProMcp','3yLwXGI','3565WlJGLX','registerEventHandler','6654VOUOfc','8842064qoaJOS','3232791gWuHBj','disconnectMCP','3091188kQlNza','executeTool','disconnect','_initialize','FUniver'];_0x1e07=function(){return _0x1f50ca;};return _0x1e07();}function _0x34ee(_0x70256d,_0x2b557d){const _0x1e07e3=_0x1e07();return _0x34ee=function(_0x34eece,_0x2f6e7c){_0x34eece=_0x34eece-0x64;let _0x45a26b=_0x1e07e3[_0x34eece];return _0x45a26b;},_0x34ee(_0x70256d,_0x2b557d);}(function(_0x181b36,_0x438e34){const _0x3f7012=_0x34ee,_0x259507=_0x181b36();while(!![]){try{const _0x1b59a4=-parseInt(_0x3f7012(0x92))/0x1*(-parseInt(_0x3f7012(0x7d))/0x2)+parseInt(_0x3f7012(0x6c))/0x3*(-parseInt(_0x3f7012(0x73))/0x4)+parseInt(_0x3f7012(0x6d))/0x5*(-parseInt(_0x3f7012(0x6f))/0x6)+parseInt(_0x3f7012(0x87))/0x7*(-parseInt(_0x3f7012(0x88))/0x8)+-parseInt(_0x3f7012(0x71))/0x9*(-parseInt(_0x3f7012(0x89))/0xa)+-parseInt(_0x3f7012(0x70))/0xb+parseInt(_0x3f7012(0x80))/0xc;if(_0x1b59a4===_0x438e34)break;else _0x259507['push'](_0x259507['shift']());}catch(_0x186a95){_0x259507['push'](_0x259507['shift']());}}}(_0x1e07,0x9e459),function(_0x2d51dc,_0x3d870c){const _0x537046=_0x34ee;typeof exports=='object'&&typeof module<'u'?_0x3d870c(require('@univerjs-pro/mcp'),require('@univerjs/core/facade'),require('@univerjs/core')):typeof define==_0x537046(0x90)&&define['amd']?define([_0x537046(0x83),_0x537046(0x81),_0x537046(0x7f)],_0x3d870c):(_0x2d51dc=typeof globalThis<'u'?globalThis:_0x2d51dc||self,_0x3d870c(_0x2d51dc[_0x537046(0x6b)],_0x2d51dc[_0x537046(0x7e)],_0x2d51dc['UniverCore']));}(this,function(_0x528b23,_0x4f2cc2,_0x456302){'use strict';const _0x2926b7=_0x34ee;class _0x51eccc{get[_0x2926b7(0x85)](){const _0x2dda36=_0x2926b7;return _0x528b23[_0x2dda36(0x82)][_0x2dda36(0x85)];}get[_0x2926b7(0x8f)](){const _0x239b4e=_0x2926b7;return _0x528b23[_0x239b4e(0x82)]['McpToolCallReceived'];}get[_0x2926b7(0x7b)](){const _0x1aedb4=_0x2926b7;return _0x528b23['MCPEventId'][_0x1aedb4(0x7b)];}get[_0x2926b7(0x93)](){const _0x3acd18=_0x2926b7;return _0x528b23[_0x3acd18(0x82)]['McpToolCallFailed'];}}_0x4f2cc2[_0x2926b7(0x65)]['extend'](_0x51eccc);class _0x53a117 extends _0x4f2cc2[_0x2926b7(0x77)]{[_0x2926b7(0x76)](_0x34c044){const _0xf5ef8c=_0x2926b7;this[_0xf5ef8c(0x6a)](_0x34c044);}[_0x2926b7(0x6a)](_0x2b296a){const _0x62a35b=_0x2926b7,_0x582dac=_0x2b296a[_0x62a35b(0x91)](_0x528b23[_0x62a35b(0x69)]);this[_0x62a35b(0x6e)](this[_0x62a35b(0x8c)][_0x62a35b(0x85)],()=>_0x456302[_0x62a35b(0x78)](_0x582dac[_0x62a35b(0x79)][_0x62a35b(0x66)](_0x35283e=>{const _0x233737=_0x62a35b;_0x35283e[_0x233737(0x8e)]===_0x528b23['MCPEventId'][_0x233737(0x85)]&&this[_0x233737(0x68)](this[_0x233737(0x8c)]['McpConnectionStatusChanged'],_0x35283e['data']);}))),this['registerEventHandler'](this[_0x62a35b(0x8c)]['McpToolCallReceived'],()=>_0x456302[_0x62a35b(0x78)](_0x582dac[_0x62a35b(0x79)][_0x62a35b(0x66)](_0x30ec04=>{const _0x3f5527=_0x62a35b;_0x30ec04[_0x3f5527(0x8e)]===_0x528b23['MCPEventId'][_0x3f5527(0x8f)]&&this[_0x3f5527(0x68)](this[_0x3f5527(0x8c)][_0x3f5527(0x8f)],_0x30ec04['data']);}))),this[_0x62a35b(0x6e)](this[_0x62a35b(0x8c)][_0x62a35b(0x7b)],()=>_0x456302['toDisposable'](_0x582dac[_0x62a35b(0x79)][_0x62a35b(0x66)](_0x328497=>{const _0x13e125=_0x62a35b;_0x328497['type']===_0x528b23['MCPEventId'][_0x13e125(0x7b)]&&this[_0x13e125(0x68)](this[_0x13e125(0x8c)][_0x13e125(0x7b)],_0x328497['data']);}))),this[_0x62a35b(0x6e)](this[_0x62a35b(0x8c)][_0x62a35b(0x93)],()=>_0x456302[_0x62a35b(0x78)](_0x582dac[_0x62a35b(0x79)][_0x62a35b(0x66)](_0x3bc5fc=>{const _0x583f51=_0x62a35b;_0x3bc5fc[_0x583f51(0x8e)]===_0x528b23[_0x583f51(0x82)][_0x583f51(0x93)]&&this['fireEvent'](this[_0x583f51(0x8c)]['McpToolCallFailed'],_0x3bc5fc[_0x583f51(0x84)]);})));}['validateMCPToolCall'](_0x46048b,_0x29091a){const _0x469cd1=_0x2926b7;return this['_injector']['get'](_0x528b23[_0x469cd1(0x86)])[_0x469cd1(0x8b)](_0x46048b,_0x29091a);}['getAllMCPTools'](){const _0x14b802=_0x2926b7;return this[_0x14b802(0x7a)][_0x14b802(0x91)](_0x528b23['IMCPToolRegistry'])[_0x14b802(0x64)]();}['callMCPTool'](_0x597335,_0xf852ca){const _0x473227=_0x2926b7;return this[_0x473227(0x7a)][_0x473227(0x91)](_0x528b23[_0x473227(0x86)])[_0x473227(0x74)](_0x597335,_0xf852ca);}['getMCPConnectionStatus'](){const _0xdf3c31=_0x2926b7;return this[_0xdf3c31(0x7a)][_0xdf3c31(0x91)](_0x528b23[_0xdf3c31(0x8d)])[_0xdf3c31(0x67)]();}['connectMCP'](){const _0x33cd73=_0x2926b7;this[_0x33cd73(0x7a)][_0x33cd73(0x91)](_0x528b23[_0x33cd73(0x8d)])[_0x33cd73(0x8a)]();}[_0x2926b7(0x72)](){const _0x34175e=_0x2926b7;this['_injector'][_0x34175e(0x91)](_0x528b23[_0x34175e(0x8d)])[_0x34175e(0x75)]();}}_0x4f2cc2['FUniver'][_0x2926b7(0x7c)](_0x53a117);}));