@theia/ai-mcp-server 1.65.0

package/README.md

@@ -0,0 +1,175 @@
+# Theia AI MCP Server
+
+This package provides Model Context Protocol (MCP) server functionality for Theia, enabling AI tools to access Theia services and workspace information.
+
+## Features
+
+- **HTTP Transport**: RESTful HTTP API for MCP communication using the StreamableHTTPServerTransport
+- **Backend MCP Contributions**: Register backend-only tools, resources, and prompts
+- **Frontend MCP Contributions**: Register frontend-only tools, resources, and prompts that can access frontend services
+- **Frontend-Backend Delegation**: Allows frontend contributions to be exposed through the backend MCP server
+
+## Development Setup
+
+### Starting the MCP Server
+
+1. Start Theia application
+2. The MCP server will automatically start and be available at `/mcp` e.g. `http://localhost:3000/mcp`
+
+## API Endpoints
+
+- `POST /mcp` - MCP protocol endpoint (for all MCP protocol operations)
+
+## Architecture
+
+The MCP server architecture consists of:
+
+1. **HTTP Transport Layer**: Manages HTTP connections using StreamableHTTPServerTransport
+2. **MCP Server**: Core server implementation that handles MCP protocol messages
+3. **Backend Contributions**: Extensions that run on the Node.js backend
+4. **Frontend Contributions**: Extensions that run in the browser frontend
+5. **Frontend-Backend Bridge**: RPC mechanism to connect frontend and backend
+
+## Creating Backend Contributions
+
+Backend contributions run in the Node.js backend and have access to backend services:
+
+```typescript
+@injectable()
+export class MyBackendContribution implements MCPBackendContribution {
+    @inject(ILogger)
+    protected readonly logger: ILogger;
+    
+    async configure(server: McpServer): Promise<void> {
+        // Register a tool
+        server.tool('my-backend-tool', {
+            type: 'object',
+            properties: {
+                input: { type: 'string' }
+            }
+        }, async (args) => {
+            this.logger.info('my-backend-tool called with args:', args);
+            return {
+                content: [{ type: 'text', text: 'Result from backend' }]
+            };
+        });
+        
+        // Register a resource
+        server.resource(
+            'my-resource',
+            'theia://resource-uri',
+            async (uri) => {
+                return {
+                    content: 'Resource content'
+                };
+            }
+        );
+        
+        // Register a prompt
+        server.prompt(
+            'my-prompt',
+            'Prompt description',
+            {}, // Arguments schema
+            async (args) => {
+                return {
+                    messages: [{
+                        role: 'user',
+                        content: { type: 'text', text: 'Prompt content' }
+                    }]
+                };
+            }
+        );
+    }
+}
+```
+
+Register the contribution in your backend module:
+
+```typescript
+bind(MyBackendContribution).toSelf().inSingletonScope();
+bind(MCPBackendContribution).toService(MyBackendContribution);
+```
+
+## Creating Frontend Contributions
+
+Frontend contributions run in the browser and have access to frontend services:
+
+```typescript
+@injectable()
+export class MyFrontendContribution implements MCPFrontendContribution {
+    @inject(WorkspaceService)
+    protected readonly workspaceService: WorkspaceService;
+    
+    async getTools(): Promise<Tool[]> {
+        return [{
+            name: 'workspace-info',
+            description: 'Get workspace info',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        }];
+    }
+    
+    async getTool(name: string): Promise<ToolProvider | undefined> {
+        if (name === 'workspace-info') {
+            return {
+                handler: async () => {
+                    const roots = await this.workspaceService.roots;
+                    return { 
+                        roots: roots.map(r => r.resource.toString()) 
+                    };
+                },
+                inputSchema: z.object({})
+            };
+        }
+    }
+    
+    async getResources(): Promise<Resource[]> {
+        return [{
+            name: 'Workspace Information',
+            uri: 'workspace://info',
+            description: 'Workspace info',
+            mimeType: 'application/json'
+        }];
+    }
+    
+    async readResource(uri: string): Promise<unknown> {
+        if (uri === 'workspace://info') {
+            const roots = await this.workspaceService.roots;
+            return { roots: roots.map(r => r.resource.toString()) };
+        }
+    }
+    
+    async getPrompts(): Promise<Prompt[]> {
+        return [{
+            name: 'workspace-context',
+            description: 'Generate workspace context',
+            arguments: []
+        }];
+    }
+    
+    async getPrompt(name: string, args: unknown): Promise<PromptMessage[]> {
+        if (name === 'workspace-context') {
+            return [{
+                role: 'user',
+                content: { type: 'text', text: 'Workspace context information' }
+            }];
+        }
+    }
+}
+```
+
+Register the contribution in your frontend module:
+
+```typescript
+bind(MyFrontendContribution).toSelf().inSingletonScope();
+bind(MCPFrontendContribution).toService(MyFrontendContribution);
+```
+
+## Security Considerations
+
+- The MCP server exposes Theia functionality over HTTP
+- Only enable the server in trusted environments
+- Consider adding authentication and authorization for production use
+- Restrict access to sensitive operations in your contributions

package/lib/browser/index.d.ts

@@ -0,0 +1,3 @@
+export * from './mcp-frontend-bootstrap';
+export * from './mcp-frontend-contribution';
+//# sourceMappingURL=index.d.ts.map

package/lib/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAgBA,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC"}

package/lib/browser/index.js

@@ -0,0 +1,21 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-frontend-bootstrap"), exports);
+tslib_1.__exportStar(require("./mcp-frontend-contribution"), exports);
+//# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,mEAAyC;AACzC,sEAA4C"}

package/lib/browser/mcp-frontend-bootstrap.d.ts

@@ -0,0 +1,17 @@
+import { MaybePromise } from '@theia/core';
+import { FrontendApplication, FrontendApplicationContribution } from '@theia/core/lib/browser';
+import { ILogger } from '@theia/core/lib/common/logger';
+import { MCPToolFrontendDelegate } from '../common/mcp-tool-delegate';
+/**
+ * Bootstraps MCP frontend components during application startup.
+ *
+ * This contribution ensures that the MCPToolFrontendDelegate is properly instantiated
+ * and available in the dependency injection container when the frontend application starts.
+ * It acts as a lightweight initializer to activate MCP functionality in the browser.
+ */
+export declare class MCPFrontendBootstrap implements FrontendApplicationContribution {
+    protected readonly frontendDelegate: MCPToolFrontendDelegate;
+    protected readonly logger: ILogger;
+    onStart(_app: FrontendApplication): MaybePromise<void>;
+}
+//# sourceMappingURL=mcp-frontend-bootstrap.d.ts.map

package/lib/browser/mcp-frontend-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-frontend-bootstrap.d.ts","sourceRoot":"","sources":["../../src/browser/mcp-frontend-bootstrap.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;GAMG;AACH,qBACa,oBAAqB,YAAW,+BAA+B;IAGxE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;IAG7D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC;CAIzD"}

package/lib/browser/mcp-frontend-bootstrap.js

@@ -0,0 +1,47 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPFrontendBootstrap = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const logger_1 = require("@theia/core/lib/common/logger");
+const mcp_tool_delegate_1 = require("../common/mcp-tool-delegate");
+/**
+ * Bootstraps MCP frontend components during application startup.
+ *
+ * This contribution ensures that the MCPToolFrontendDelegate is properly instantiated
+ * and available in the dependency injection container when the frontend application starts.
+ * It acts as a lightweight initializer to activate MCP functionality in the browser.
+ */
+let MCPFrontendBootstrap = class MCPFrontendBootstrap {
+    onStart(_app) {
+        this.logger.debug('MCPFrontendBootstrap initialized');
+    }
+};
+exports.MCPFrontendBootstrap = MCPFrontendBootstrap;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(mcp_tool_delegate_1.MCPToolFrontendDelegate),
+    tslib_1.__metadata("design:type", Object)
+], MCPFrontendBootstrap.prototype, "frontendDelegate", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(logger_1.ILogger),
+    tslib_1.__metadata("design:type", Object)
+], MCPFrontendBootstrap.prototype, "logger", void 0);
+exports.MCPFrontendBootstrap = MCPFrontendBootstrap = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], MCPFrontendBootstrap);
+//# sourceMappingURL=mcp-frontend-bootstrap.js.map

package/lib/browser/mcp-frontend-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-frontend-bootstrap.js","sourceRoot":"","sources":["../../src/browser/mcp-frontend-bootstrap.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAAkE;AAGlE,0DAAwD;AACxD,mEAAsE;AAEtE;;;;;;GAMG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAQ7B,OAAO,CAAC,IAAyB;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC1D,CAAC;CAEJ,CAAA;AAZY,oDAAoB;AAGV;IADlB,IAAA,kBAAM,EAAC,2CAAuB,CAAC;;8DAC6B;AAG1C;IADlB,IAAA,kBAAM,EAAC,gBAAO,CAAC;;oDACmB;+BAN1B,oBAAoB;IADhC,IAAA,sBAAU,GAAE;GACA,oBAAoB,CAYhC"}

package/lib/browser/mcp-frontend-contribution.d.ts

@@ -0,0 +1,44 @@
+import { ContributionProvider } from '@theia/core/lib/common/contribution-provider';
+import { Tool, Resource, Prompt, PromptMessage } from '@modelcontextprotocol/sdk/types';
+import { z } from 'zod';
+export declare const MCPFrontendContribution: unique symbol;
+/**
+ * Tool provider interface for frontend contributions
+ */
+export interface ToolProvider {
+    handler: (args: unknown) => Promise<unknown>;
+    inputSchema: z.ZodSchema;
+}
+/**
+ * Contribution interface for extending the MCP server with frontend-only tools, resources, and prompts
+ */
+export interface MCPFrontendContribution {
+    /**
+     * Get tools provided by this contribution
+     */
+    getTools?(): Promise<Tool[]> | Tool[];
+    /**
+     * Get specific tool by name
+     */
+    getTool?(name: string): Promise<ToolProvider | undefined> | ToolProvider | undefined;
+    /**
+     * Get resources provided by this contribution
+     */
+    getResources?(): Promise<Resource[]> | Resource[];
+    /**
+     * Read specific resource by URI
+     */
+    readResource?(uri: string): Promise<unknown> | unknown;
+    /**
+     * Get prompts provided by this contribution
+     */
+    getPrompts?(): Promise<Prompt[]> | Prompt[];
+    /**
+     * Get specific prompt by name with arguments
+     */
+    getPrompt?(name: string, args: unknown): Promise<PromptMessage[]> | PromptMessage[];
+}
+export declare const MCPFrontendContributionProvider: unique symbol;
+export interface MCPFrontendContributionProvider extends ContributionProvider<MCPFrontendContribution> {
+}
+//# sourceMappingURL=mcp-frontend-contribution.d.ts.map

package/lib/browser/mcp-frontend-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-frontend-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/mcp-frontend-contribution.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACxF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB,eAAoC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,YAAY,GAAG,SAAS,CAAC;IAErF;;OAEG;IACH,YAAY,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;IAElD;;OAEG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAEvD;;OAEG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;IAE5C;;OAEG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;CACvF;AAED,eAAO,MAAM,+BAA+B,eAA4C,CAAC;AACzF,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB,CAAC,uBAAuB,CAAC;CAAI"}

package/lib/browser/mcp-frontend-contribution.js

@@ -0,0 +1,21 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPFrontendContributionProvider = exports.MCPFrontendContribution = void 0;
+exports.MCPFrontendContribution = Symbol('MCPFrontendContribution');
+exports.MCPFrontendContributionProvider = Symbol('MCPFrontendContributionProvider');
+//# sourceMappingURL=mcp-frontend-contribution.js.map

package/lib/browser/mcp-frontend-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-frontend-contribution.js","sourceRoot":"","sources":["../../src/browser/mcp-frontend-contribution.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAMnE,QAAA,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AA6C5D,QAAA,+BAA+B,GAAG,MAAM,CAAC,iCAAiC,CAAC,CAAC"}

package/lib/browser/mcp-frontend-module.d.ts

@@ -0,0 +1,4 @@
+import { ContainerModule } from '@theia/core/shared/inversify';
+declare const _default: ContainerModule;
+export default _default;
+//# sourceMappingURL=mcp-frontend-module.d.ts.map

package/lib/browser/mcp-frontend-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-frontend-module.d.ts","sourceRoot":"","sources":["../../src/browser/mcp-frontend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;;AAY/D,wBAaG"}

package/lib/browser/mcp-frontend-module.js

@@ -0,0 +1,37 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const inversify_1 = require("@theia/core/shared/inversify");
+const core_1 = require("@theia/core");
+const browser_1 = require("@theia/core/lib/browser");
+const service_connection_provider_1 = require("@theia/core/lib/browser/messaging/service-connection-provider");
+const mcp_tool_delegate_1 = require("../common/mcp-tool-delegate");
+const mcp_frontend_bootstrap_1 = require("./mcp-frontend-bootstrap");
+const mcp_frontend_contribution_1 = require("./mcp-frontend-contribution");
+const mcp_tool_delegate_client_1 = require("./mcp-tool-delegate-client");
+exports.default = new inversify_1.ContainerModule(bind => {
+    bind(mcp_frontend_bootstrap_1.MCPFrontendBootstrap).toSelf().inSingletonScope();
+    bind(browser_1.FrontendApplicationContribution).toService(mcp_frontend_bootstrap_1.MCPFrontendBootstrap);
+    bind(mcp_tool_delegate_1.MCPToolDelegateClient).to(mcp_tool_delegate_client_1.MCPToolDelegateClientImpl).inSingletonScope();
+    bind(mcp_tool_delegate_1.MCPToolFrontendDelegate).toDynamicValue(ctx => {
+        const connection = ctx.container.get(service_connection_provider_1.RemoteConnectionProvider);
+        const client = ctx.container.get(mcp_tool_delegate_1.MCPToolDelegateClient);
+        return connection.createProxy(mcp_tool_delegate_1.mcpToolDelegatePath, client);
+    }).inSingletonScope();
+    (0, core_1.bindContributionProvider)(bind, mcp_frontend_contribution_1.MCPFrontendContribution);
+});
+//# sourceMappingURL=mcp-frontend-module.js.map

package/lib/browser/mcp-frontend-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-frontend-module.js","sourceRoot":"","sources":["../../src/browser/mcp-frontend-module.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,4DAA+D;AAC/D,sCAAuD;AACvD,qDAA0E;AAC1E,+GAGuE;AACvE,mEAAkH;AAClH,qEAAgE;AAChE,2EAAsE;AACtE,yEAAuE;AAEvE,kBAAe,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IACtC,IAAI,CAAC,6CAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACvD,IAAI,CAAC,yCAA+B,CAAC,CAAC,SAAS,CAAC,6CAAoB,CAAC,CAAC;IAEtE,IAAI,CAAC,yCAAqB,CAAC,CAAC,EAAE,CAAC,oDAAyB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAE7E,IAAI,CAAC,2CAAuB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;QAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAA4B,sDAAwB,CAAC,CAAC;QAC1F,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAwB,yCAAqB,CAAC,CAAC;QAC/E,OAAO,UAAU,CAAC,WAAW,CAA0B,uCAAmB,EAAE,MAAM,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEtB,IAAA,+BAAwB,EAAC,IAAI,EAAE,mDAAuB,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC"}

package/lib/browser/mcp-tool-delegate-client.d.ts

@@ -0,0 +1,27 @@
+import { ContributionProvider } from '@theia/core';
+import { ILogger } from '@theia/core/lib/common/logger';
+import { Tool, Resource, ResourceContents, Prompt, PromptMessage } from '@modelcontextprotocol/sdk/types';
+import { MCPToolDelegateClient } from '../common/mcp-tool-delegate';
+import { MCPFrontendContribution } from './mcp-frontend-contribution';
+/**
+ * Frontend client implementation that handles MCP tool delegation requests from the backend.
+ *
+ * This class acts as a bridge between the backend MCP server and frontend contributions,
+ * forwarding backend requests (tool calls, resource access, prompts) to registered
+ * MCPFrontendContribution instances and aggregating their responses.
+ *
+ * Called by the backend via the MCPToolDelegateClient interface to access frontend-provided
+ * MCP tools, resources, and prompts.
+ */
+export declare class MCPToolDelegateClientImpl implements MCPToolDelegateClient {
+    protected readonly contributions: ContributionProvider<MCPFrontendContribution>;
+    protected readonly logger: ILogger;
+    private getFrontendContributions;
+    callTool(serverId: string, toolName: string, args: unknown): Promise<unknown>;
+    listTools(serverId: string): Promise<Tool[]>;
+    listResources(serverId: string): Promise<Resource[]>;
+    readResource(serverId: string, uri: string): Promise<ResourceContents>;
+    listPrompts(serverId: string): Promise<Prompt[]>;
+    getPrompt(serverId: string, name: string, args: unknown): Promise<PromptMessage[]>;
+}
+//# sourceMappingURL=mcp-tool-delegate-client.d.ts.map

package/lib/browser/mcp-tool-delegate-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-delegate-client.d.ts","sourceRoot":"","sources":["../../src/browser/mcp-tool-delegate-client.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAC1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;GASG;AACH,qBACa,yBAA0B,YAAW,qBAAqB;IAInE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC,uBAAuB,CAAC,CAAC;IAGhF,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,OAAO,CAAC,wBAAwB;IAI1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAc7E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAa5C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAapD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBtE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAahD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAe3F"}

package/lib/browser/mcp-tool-delegate-client.js

@@ -0,0 +1,128 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPToolDelegateClientImpl = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const core_1 = require("@theia/core");
+const logger_1 = require("@theia/core/lib/common/logger");
+const mcp_frontend_contribution_1 = require("./mcp-frontend-contribution");
+/**
+ * Frontend client implementation that handles MCP tool delegation requests from the backend.
+ *
+ * This class acts as a bridge between the backend MCP server and frontend contributions,
+ * forwarding backend requests (tool calls, resource access, prompts) to registered
+ * MCPFrontendContribution instances and aggregating their responses.
+ *
+ * Called by the backend via the MCPToolDelegateClient interface to access frontend-provided
+ * MCP tools, resources, and prompts.
+ */
+let MCPToolDelegateClientImpl = class MCPToolDelegateClientImpl {
+    getFrontendContributions() {
+        return this.contributions.getContributions();
+    }
+    async callTool(serverId, toolName, args) {
+        const contributions = this.getFrontendContributions();
+        for (const contribution of contributions) {
+            if (contribution.getTool) {
+                const tool = await contribution.getTool(toolName);
+                if (tool) {
+                    return await tool.handler(JSON.stringify(args));
+                }
+            }
+        }
+        throw new Error(`Tool ${toolName} not found in server ${serverId}`);
+    }
+    async listTools(serverId) {
+        const contributions = this.getFrontendContributions();
+        const allTools = [];
+        for (const contribution of contributions) {
+            if (contribution.getTools) {
+                const tools = await contribution.getTools();
+                allTools.push(...tools);
+            }
+        }
+        return allTools;
+    }
+    async listResources(serverId) {
+        const contributions = this.getFrontendContributions();
+        const allResources = [];
+        for (const contribution of contributions) {
+            if (contribution.getResources) {
+                const resources = await contribution.getResources();
+                allResources.push(...resources);
+            }
+        }
+        return allResources;
+    }
+    async readResource(serverId, uri) {
+        const contributions = this.getFrontendContributions();
+        for (const contribution of contributions) {
+            if (contribution.readResource) {
+                try {
+                    const result = await contribution.readResource(uri);
+                    return result;
+                }
+                catch (error) {
+                    // Continue to next contribution
+                    this.logger.debug(`Error getting resource ${uri}:`, error);
+                }
+            }
+        }
+        throw new Error(`Resource ${uri} not found in server ${serverId}`);
+    }
+    async listPrompts(serverId) {
+        const contributions = this.getFrontendContributions();
+        const allPrompts = [];
+        for (const contribution of contributions) {
+            if (contribution.getPrompts) {
+                const prompts = await contribution.getPrompts();
+                allPrompts.push(...prompts);
+            }
+        }
+        return allPrompts;
+    }
+    async getPrompt(serverId, name, args) {
+        const contributions = this.getFrontendContributions();
+        for (const contribution of contributions) {
+            if (contribution.getPrompt) {
+                try {
+                    return await contribution.getPrompt(name, args);
+                }
+                catch (error) {
+                    // Continue to next contribution
+                    this.logger.debug(`Error getting prompt ${name}:`, error);
+                }
+            }
+        }
+        throw new Error(`Prompt ${name} not found in server ${serverId}`);
+    }
+};
+exports.MCPToolDelegateClientImpl = MCPToolDelegateClientImpl;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ContributionProvider),
+    (0, inversify_1.named)(mcp_frontend_contribution_1.MCPFrontendContribution),
+    tslib_1.__metadata("design:type", Object)
+], MCPToolDelegateClientImpl.prototype, "contributions", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(logger_1.ILogger),
+    tslib_1.__metadata("design:type", Object)
+], MCPToolDelegateClientImpl.prototype, "logger", void 0);
+exports.MCPToolDelegateClientImpl = MCPToolDelegateClientImpl = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], MCPToolDelegateClientImpl);
+//# sourceMappingURL=mcp-tool-delegate-client.js.map

package/lib/browser/mcp-tool-delegate-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-delegate-client.js","sourceRoot":"","sources":["../../src/browser/mcp-tool-delegate-client.ts"],"names":[],"mappings":"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"}

package/lib/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mcp-tool-delegate';
+//# sourceMappingURL=index.d.ts.map

package/lib/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAgBA,cAAc,qBAAqB,CAAC"}

package/lib/common/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2025 EclipseSource.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-tool-delegate"), exports);
+//# sourceMappingURL=index.js.map

package/lib/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,8DAAoC"}

package/lib/common/mcp-tool-delegate.d.ts

@@ -0,0 +1,25 @@
+import { Tool, Resource, ResourceContents, Prompt, PromptMessage } from '@modelcontextprotocol/sdk/types';
+export declare const MCPToolDelegateClient: unique symbol;
+/**
+ * Client interface for MCP tool operations.
+ * This interface is implemented by the frontend and called by the backend.
+ */
+export interface MCPToolDelegateClient {
+    callTool(serverId: string, toolName: string, args: unknown): Promise<unknown>;
+    listTools(serverId: string): Promise<Tool[]>;
+    listResources(serverId: string): Promise<Resource[]>;
+    readResource(serverId: string, uri: string): Promise<ResourceContents>;
+    listPrompts(serverId: string): Promise<Prompt[]>;
+    getPrompt(serverId: string, name: string, args: unknown): Promise<PromptMessage[]>;
+}
+export declare const MCPToolFrontendDelegate: unique symbol;
+/**
+ * Backend delegate interface for MCP tool operations.
+ * This interface extends MCPToolDelegateClient with RPC client setup capability.
+ * It is implemented by the backend and acts as a proxy to forward calls to the frontend.
+ */
+export interface MCPToolFrontendDelegate extends MCPToolDelegateClient {
+    setClient(client: MCPToolDelegateClient): void;
+}
+export declare const mcpToolDelegatePath = "/services/mcpToolDelegate";
+//# sourceMappingURL=mcp-tool-delegate.d.ts.map

package/lib/common/mcp-tool-delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-delegate.d.ts","sourceRoot":"","sources":["../../src/common/mcp-tool-delegate.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE1G,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AACrE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACtF;AAED,eAAO,MAAM,uBAAuB,eAAoC,CAAC;AACzE;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IAClE,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAClD;AAED,eAAO,MAAM,mBAAmB,8BAA8B,CAAC"}