@eggjs/mcp-client-plugin 0.0.0 → 4.0.2-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-present Alibaba Group Holding Limited and other contributors.
+
+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/_virtual/_@oxc-project_runtime@0.103.0/helpers/decorate.js

@@ -0,0 +1,10 @@
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+export { __decorate };

package/dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/decorateMetadata.js

@@ -0,0 +1,7 @@
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+
+//#endregion
+export { __decorateMetadata };

package/dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/decorateParam.js

@@ -0,0 +1,9 @@
+//#region \0@oxc-project+runtime@0.103.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+
+//#endregion
+export { __decorateParam };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { McpMethod } from "./lib/constants.js";
+import { QualifierUtil } from "./lib/QualifierUtil.js";
+import { HttpMCPClientFactory } from "./lib/HttpMCPClientFactory.js";
+export { HttpMCPClientFactory, McpMethod, QualifierUtil };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { McpMethod } from "./lib/constants.js";
+import { QualifierUtil } from "./lib/QualifierUtil.js";
+import { HttpMCPClientFactory } from "./lib/HttpMCPClientFactory.js";
+
+export { HttpMCPClientFactory, McpMethod, QualifierUtil };

package/dist/lib/EggHttpMCPClient.d.ts

@@ -0,0 +1,28 @@
+import { Logger } from "@eggjs/tegg";
+import { fetch } from "urllib";
+import { HttpClientOptions, HttpMCPClient } from "@eggjs/mcp-client";
+
+//#region src/lib/EggHttpMCPClient.d.ts
+interface EggHttpMCPClientOptions {
+  clientName: string;
+  clientVersion: string;
+  logger: Logger;
+  transportOptions?: HttpClientOptions["transportOptions"];
+  requestOptions?: HttpClientOptions["requestOptions"];
+  fetch: typeof fetch;
+  transportType: HttpClientOptions["transportType"];
+  url: string;
+}
+declare class EggHttpMCPClient extends HttpMCPClient {
+  protected readonly logger: Logger;
+  constructor(options: EggHttpMCPClientOptions);
+  init(): Promise<void>;
+  listTools(params?: Parameters<HttpMCPClient["listTools"]>["0"], options?: Parameters<HttpMCPClient["listTools"]>["1"]): ReturnType<HttpMCPClient["listTools"]>;
+  listPrompts(params?: Parameters<HttpMCPClient["listPrompts"]>["0"], options?: Parameters<HttpMCPClient["listPrompts"]>["1"]): ReturnType<HttpMCPClient["listPrompts"]>;
+  listResources(params?: Parameters<HttpMCPClient["listResources"]>["0"], options?: Parameters<HttpMCPClient["listResources"]>["1"]): ReturnType<HttpMCPClient["listResources"]>;
+  connect(transport: Parameters<HttpMCPClient["connect"]>["0"], options?: Parameters<HttpMCPClient["connect"]>["1"]): ReturnType<HttpMCPClient["connect"]>;
+  notification(notification: Parameters<HttpMCPClient["notification"]>["0"], options?: Parameters<HttpMCPClient["notification"]>["1"]): ReturnType<HttpMCPClient["notification"]>;
+  callTool(params: Parameters<HttpMCPClient["callTool"]>["0"], resultSchema?: Parameters<HttpMCPClient["callTool"]>["1"], options?: Parameters<HttpMCPClient["callTool"]>["2"]): ReturnType<HttpMCPClient["callTool"]>;
+}
+//#endregion
+export { EggHttpMCPClient, EggHttpMCPClientOptions };

package/dist/lib/EggHttpMCPClient.js

@@ -0,0 +1,74 @@
+import { McpMethod } from "./constants.js";
+import { HttpMCPClient, mergeHeaders } from "@eggjs/mcp-client";
+import { ContextHandler } from "@eggjs/tegg-runtime";
+
+//#region src/lib/EggHttpMCPClient.ts
+const MCP_METHOD = Symbol("Context#mcpMethod");
+const MCP_TOOL = Symbol("Context#mcpTool");
+var EggHttpMCPClient = class extends HttpMCPClient {
+	constructor(options) {
+		super({
+			name: options.clientName,
+			version: options.clientVersion
+		}, {
+			fetch: options.fetch,
+			transportType: options.transportType,
+			url: options.url,
+			logger: options.logger,
+			transportOptions: {
+				...options.transportOptions,
+				get requestInit() {
+					return {
+						...options.transportOptions?.requestInit,
+						get headers() {
+							return mergeHeaders(options.transportOptions?.requestInit?.headers);
+						}
+					};
+				}
+			},
+			requestOptions: options.requestOptions
+		});
+		this.logger = options.logger;
+	}
+	async init() {
+		await super.init();
+	}
+	async listTools(params, options) {
+		const context = ContextHandler.getContext();
+		if (context) context.set(MCP_METHOD, McpMethod.LIST_TOOLS);
+		return super.listTools(params, options);
+	}
+	async listPrompts(params, options) {
+		const context = ContextHandler.getContext();
+		if (context) context.set(MCP_METHOD, McpMethod.LIST_PROMPTS);
+		return super.listPrompts(params, options);
+	}
+	async listResources(params, options) {
+		const context = ContextHandler.getContext();
+		if (context) context.set(MCP_METHOD, McpMethod.LIST_RESOURCES);
+		return super.listResources(params, options);
+	}
+	async connect(transport, options) {
+		const context = ContextHandler.getContext();
+		if (context) context.set(MCP_METHOD, McpMethod.INITIALIZE);
+		return super.connect(transport, options);
+	}
+	async notification(notification, options) {
+		if (notification?.method === "notifications/initialized") {
+			const context = ContextHandler.getContext();
+			if (context) context.set(MCP_METHOD, McpMethod.NOTIFICATION_INIT);
+		}
+		return super.notification(notification, options);
+	}
+	async callTool(params, resultSchema, options) {
+		const context = ContextHandler.getContext();
+		if (context) {
+			context.set(MCP_TOOL, params?.name);
+			context.set(MCP_METHOD, McpMethod.CALL_TOOLS);
+		}
+		return super.callTool(params, resultSchema, options);
+	}
+};
+
+//#endregion
+export { EggHttpMCPClient };

package/dist/lib/EggHttpStaticMCPClient.d.ts

@@ -0,0 +1,10 @@
+import { EggHttpMCPClient } from "./EggHttpMCPClient.js";
+import { Logger, ModuleConfig, ObjectInfo } from "@eggjs/tegg";
+
+//#region src/lib/EggHttpStaticMCPClient.d.ts
+declare class EggHttpStaticMCPClient extends EggHttpMCPClient {
+  constructor(moduleConfig: ModuleConfig, logger: Logger, objInfo: ObjectInfo);
+  _init(): Promise<void>;
+}
+//#endregion
+export { EggHttpStaticMCPClient };

package/dist/lib/EggHttpStaticMCPClient.js

@@ -0,0 +1,74 @@
+import { QualifierUtil } from "./QualifierUtil.js";
+import { EggHttpMCPClient } from "./EggHttpMCPClient.js";
+import { __decorateMetadata } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/decorateMetadata.js";
+import { __decorate } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/decorate.js";
+import { __decorateParam } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/decorateParam.js";
+import { AccessLevel, Inject, LifecycleInit, MultiInstanceInfo, MultiInstanceProto, ObjectInitType } from "@eggjs/tegg";
+import { fetch } from "urllib";
+import { MCPClientInjectName, MCPClientQualifierAttribute, getMCPClientConfig, getMCPClientName } from "@eggjs/mcp-client";
+import assert from "node:assert";
+import { ModuleConfigUtil } from "@eggjs/tegg/helper";
+
+//#region src/lib/EggHttpStaticMCPClient.ts
+let EggHttpStaticMCPClient = class EggHttpStaticMCPClient$1 extends EggHttpMCPClient {
+	constructor(moduleConfig, logger, objInfo) {
+		const configName = getMCPClientName(objInfo);
+		const sseClientConfig = getMCPClientConfig(moduleConfig, objInfo);
+		const clientName = sseClientConfig.clientName ?? configName;
+		const mcpServerSubConfig = { ...sseClientConfig };
+		assert(mcpServerSubConfig.url, `not found mcpServerSubConfig.url for ${clientName}`);
+		super({
+			clientName,
+			clientVersion: sseClientConfig.version ?? "1.0.0",
+			transportType: mcpServerSubConfig.transportType,
+			url: mcpServerSubConfig.url,
+			logger,
+			fetch
+		});
+	}
+	async _init() {
+		await super.init();
+	}
+};
+__decorate([
+	LifecycleInit(),
+	__decorateMetadata("design:type", Function),
+	__decorateMetadata("design:paramtypes", []),
+	__decorateMetadata("design:returntype", Promise)
+], EggHttpStaticMCPClient.prototype, "_init", null);
+EggHttpStaticMCPClient = __decorate([
+	MultiInstanceProto({
+		accessLevel: AccessLevel.PUBLIC,
+		initType: ObjectInitType.SINGLETON,
+		getObjects(ctx) {
+			const config = ModuleConfigUtil.loadModuleConfigSync(ctx.unitPath);
+			const moduleName = ModuleConfigUtil.readModuleNameSync(ctx.unitPath);
+			const clients = config?.mcp?.clients;
+			if (!clients) return [];
+			return Object.keys(clients).filter((clientName) => {
+				return clients[clientName].type === "http";
+			}).map((clientName) => {
+				const properQualifiers = { ...QualifierUtil.getModuleConfigQualifier(moduleName) };
+				return {
+					name: MCPClientInjectName,
+					qualifiers: [{
+						attribute: MCPClientQualifierAttribute,
+						value: clientName
+					}],
+					properQualifiers
+				};
+			});
+		}
+	}),
+	__decorateParam(0, Inject()),
+	__decorateParam(1, Inject()),
+	__decorateParam(2, MultiInstanceInfo([MCPClientQualifierAttribute])),
+	__decorateMetadata("design:paramtypes", [
+		Object,
+		Object,
+		Object
+	])
+], EggHttpStaticMCPClient);
+
+//#endregion
+export { EggHttpStaticMCPClient };

package/dist/lib/HttpMCPClientFactory.d.ts

@@ -0,0 +1,11 @@
+import { EggHttpMCPClient } from "./EggHttpMCPClient.js";
+import { HttpClientOptions } from "@eggjs/mcp-client";
+import { Implementation } from "@modelcontextprotocol/sdk/types.js";
+
+//#region src/lib/HttpMCPClientFactory.d.ts
+declare class HttpMCPClientFactory {
+  private readonly logger;
+  build(clientInfo: Implementation, options: Omit<HttpClientOptions, "logger">): Promise<EggHttpMCPClient>;
+}
+//#endregion
+export { HttpMCPClientFactory };

package/dist/lib/HttpMCPClientFactory.js

@@ -0,0 +1,29 @@
+import { EggHttpMCPClient } from "./EggHttpMCPClient.js";
+import { __decorateMetadata } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/decorateMetadata.js";
+import { __decorate } from "../_virtual/_@oxc-project_runtime@0.103.0/helpers/decorate.js";
+import { AccessLevel, Inject, SingletonProto } from "@eggjs/tegg";
+import { fetch } from "urllib";
+
+//#region src/lib/HttpMCPClientFactory.ts
+let HttpMCPClientFactory = class HttpMCPClientFactory$1 {
+	logger;
+	async build(clientInfo, options) {
+		const httpMCPClient = new EggHttpMCPClient({
+			clientName: clientInfo.name,
+			clientVersion: clientInfo.version,
+			fetch,
+			...options,
+			logger: this.logger
+		});
+		await httpMCPClient.init();
+		return httpMCPClient;
+	}
+};
+__decorate([Inject(), __decorateMetadata("design:type", Object)], HttpMCPClientFactory.prototype, "logger", void 0);
+HttpMCPClientFactory = __decorate([SingletonProto({
+	accessLevel: AccessLevel.PUBLIC,
+	name: "httpMcpClientFactory"
+})], HttpMCPClientFactory);
+
+//#endregion
+export { HttpMCPClientFactory };

package/dist/lib/QualifierUtil.d.ts

@@ -0,0 +1,8 @@
+import { QualifierInfo } from "@eggjs/tegg";
+
+//#region src/lib/QualifierUtil.d.ts
+declare class QualifierUtil {
+  static getModuleConfigQualifier(moduleName: string): Record<string, QualifierInfo[]>;
+}
+//#endregion
+export { QualifierUtil };

package/dist/lib/QualifierUtil.js

@@ -0,0 +1,14 @@
+import { ConfigSourceQualifierAttribute } from "@eggjs/tegg";
+
+//#region src/lib/QualifierUtil.ts
+var QualifierUtil = class {
+	static getModuleConfigQualifier(moduleName) {
+		return { moduleConfig: [{
+			attribute: ConfigSourceQualifierAttribute,
+			value: moduleName
+		}] };
+	}
+};
+
+//#endregion
+export { QualifierUtil };

package/dist/lib/constants.d.ts

@@ -0,0 +1,12 @@
+//#region src/lib/constants.d.ts
+declare const McpMethod: {
+  readonly INITIALIZE: "initialize";
+  readonly NOTIFICATION_INIT: "notifications/initialized";
+  readonly LIST_TOOLS: "tools/list";
+  readonly CALL_TOOLS: "tools/call";
+  readonly LIST_PROMPTS: "prompts/list";
+  readonly LIST_RESOURCES: "resources/list";
+};
+type McpMethod = (typeof McpMethod)[keyof typeof McpMethod];
+//#endregion
+export { McpMethod };

package/dist/lib/constants.js

@@ -0,0 +1,12 @@
+//#region src/lib/constants.ts
+const McpMethod = {
+	INITIALIZE: "initialize",
+	NOTIFICATION_INIT: "notifications/initialized",
+	LIST_TOOLS: "tools/list",
+	CALL_TOOLS: "tools/call",
+	LIST_PROMPTS: "prompts/list",
+	LIST_RESOURCES: "resources/list"
+};
+
+//#endregion
+export { McpMethod };

package/package.json

@@ -1,31 +1,75 @@
 {
   "name": "@eggjs/mcp-client-plugin",
-  "version": "0.0.0",
-  "description": "egg logger",
+  "version": "4.0.2-beta.0",
+  "description": "mcp client for egg",
   "keywords": [
     "egg",
-    "logger"
+    "mcp",
+    "module",
+    "plugin",
+    "tegg",
+    "typescript"
   ],
-  "homepage": "https://github.com/eggjs/egg/tree/next/packages/logger",
+  "homepage": "https://github.com/eggjs/egg/tree/next/tegg/plugin/mcp-client",
   "bugs": {
     "url": "https://github.com/eggjs/egg/issues"
   },
-  "license": "MIT",
-  "author": "fengmk2 <fengmk2@gmail.com> (https://github.com/fengmk2)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/eggjs/egg.git",
-    "directory": "packages/logger"
+    "directory": "tegg/plugin/mcp-client"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./lib/constants": "./dist/lib/constants.js",
+    "./lib/EggHttpMCPClient": "./dist/lib/EggHttpMCPClient.js",
+    "./lib/EggHttpStaticMCPClient": "./dist/lib/EggHttpStaticMCPClient.js",
+    "./lib/HttpMCPClientFactory": "./dist/lib/HttpMCPClientFactory.js",
+    "./lib/QualifierUtil": "./dist/lib/QualifierUtil.js",
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.23.0",
+    "urllib": "^4.8.2",
+    "@eggjs/mcp-client": "4.0.2-beta.0",
+    "@eggjs/tegg": "4.0.2-beta.0",
+    "@eggjs/tegg-runtime": "4.0.2-beta.0"
   },
   "devDependencies": {
+    "@types/node": "^24.10.2",
+    "typescript": "^5.9.3",
+    "zod": "^3.24.1",
+    "@eggjs/mock": "7.0.2-beta.0",
+    "@eggjs/controller-plugin": "4.0.2-beta.0",
+    "@eggjs/tegg-config": "4.0.2-beta.0"
+  },
+  "peerDependencies": {
+    "@eggjs/tegg-plugin": "4.0.2-beta.0",
+    "egg": "4.1.2-beta.0"
   },
   "engines": {
-    "node": ">= 22.18.0"
+    "node": ">=22.18.0"
+  },
+  "eggModule": {
+    "name": "teggMcpClient"
+  },
+  "eggPlugin": {
+    "name": "teggMcpClient",
+    "dependencies": [
+      "tegg"
+    ]
+  },
+  "scripts": {
+    "typecheck": "tsgo --noEmit"
   }
-}
-
+}