@loopstack/mcp-module 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +213 -0
  2. package/dist/config/mcp-tool-config.schema.d.ts +11 -0
  3. package/dist/config/mcp-tool-config.schema.d.ts.map +1 -0
  4. package/dist/config/mcp-tool-config.schema.js +38 -0
  5. package/dist/config/mcp-tool-config.schema.js.map +1 -0
  6. package/dist/errors.d.ts +14 -0
  7. package/dist/errors.d.ts.map +1 -0
  8. package/dist/errors.js +17 -0
  9. package/dist/errors.js.map +1 -0
  10. package/dist/index.d.ts +8 -0
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +8 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/mcp.module.d.ts +3 -0
  15. package/dist/mcp.module.d.ts.map +1 -0
  16. package/dist/mcp.module.js +31 -0
  17. package/dist/mcp.module.js.map +1 -0
  18. package/dist/services/env-reader.d.ts +8 -0
  19. package/dist/services/env-reader.d.ts.map +1 -0
  20. package/dist/services/env-reader.js +10 -0
  21. package/dist/services/env-reader.js.map +1 -0
  22. package/dist/services/index.d.ts +5 -0
  23. package/dist/services/index.d.ts.map +1 -0
  24. package/dist/services/index.js +5 -0
  25. package/dist/services/index.js.map +1 -0
  26. package/dist/services/mcp-client.service.d.ts +39 -0
  27. package/dist/services/mcp-client.service.d.ts.map +1 -0
  28. package/dist/services/mcp-client.service.js +309 -0
  29. package/dist/services/mcp-client.service.js.map +1 -0
  30. package/dist/services/mcp-sdk.types.d.ts +14 -0
  31. package/dist/services/mcp-sdk.types.d.ts.map +1 -0
  32. package/dist/services/mcp-sdk.types.js +2 -0
  33. package/dist/services/mcp-sdk.types.js.map +1 -0
  34. package/dist/services/metrics-port.d.ts +26 -0
  35. package/dist/services/metrics-port.d.ts.map +1 -0
  36. package/dist/services/metrics-port.js +6 -0
  37. package/dist/services/metrics-port.js.map +1 -0
  38. package/dist/tools/index.d.ts +5 -0
  39. package/dist/tools/index.d.ts.map +1 -0
  40. package/dist/tools/index.js +5 -0
  41. package/dist/tools/index.js.map +1 -0
  42. package/dist/tools/mcp-call.tool.d.ts +19 -0
  43. package/dist/tools/mcp-call.tool.d.ts.map +1 -0
  44. package/dist/tools/mcp-call.tool.js +36 -0
  45. package/dist/tools/mcp-call.tool.js.map +1 -0
  46. package/dist/tools/mcp-connection-args.schema.d.ts +11 -0
  47. package/dist/tools/mcp-connection-args.schema.d.ts.map +1 -0
  48. package/dist/tools/mcp-connection-args.schema.js +13 -0
  49. package/dist/tools/mcp-connection-args.schema.js.map +1 -0
  50. package/dist/tools/mcp-list-tools.tool.d.ts +17 -0
  51. package/dist/tools/mcp-list-tools.tool.d.ts.map +1 -0
  52. package/dist/tools/mcp-list-tools.tool.js +32 -0
  53. package/dist/tools/mcp-list-tools.tool.js.map +1 -0
  54. package/dist/tools/mcp-tool-base.d.ts +8 -0
  55. package/dist/tools/mcp-tool-base.d.ts.map +1 -0
  56. package/dist/tools/mcp-tool-base.js +26 -0
  57. package/dist/tools/mcp-tool-base.js.map +1 -0
  58. package/dist/types.d.ts +2 -0
  59. package/dist/types.d.ts.map +1 -0
  60. package/dist/types.js +2 -0
  61. package/dist/types.js.map +1 -0
  62. package/dist/utils/url-security.d.ts +8 -0
  63. package/dist/utils/url-security.d.ts.map +1 -0
  64. package/dist/utils/url-security.js +192 -0
  65. package/dist/utils/url-security.js.map +1 -0
  66. package/package.json +50 -0
@@ -0,0 +1,309 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
11
+ return function (target, key) { decorator(target, key, paramIndex); }
12
+ };
13
+ var McpClientService_1;
14
+ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
15
+ import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
16
+ import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
17
+ import { Inject, Injectable, Logger, Optional } from '@nestjs/common';
18
+ import { readFileSync } from 'node:fs';
19
+ import { join } from 'node:path';
20
+ import { McpAuthError, McpProtocolError, McpTimeoutError, McpTransportError, McpUrlSecurityError } from '../errors.js';
21
+ import { assertMcpUrlSafe } from '../utils/url-security.js';
22
+ import { MCP_ENV_READER, ProcessEnvReader } from './env-reader.js';
23
+ import { MCP_METRICS, NoopMcpMetrics, } from './metrics-port.js';
24
+ const { version: PKG_VERSION } = JSON.parse(readFileSync(join(import.meta.dirname, '..', '..', 'package.json'), 'utf8'));
25
+ const CLIENT_INFO = { name: 'loopstack-mcp-module', version: PKG_VERSION };
26
+ const DEFAULT_TIMEOUT_MS = 60_000;
27
+ const OUTER_TIMEOUT_BUFFER_MS = 15_000;
28
+ const OUTER_TIMEOUT_MULTIPLIER = 2;
29
+ let McpClientService = McpClientService_1 = class McpClientService {
30
+ env;
31
+ metrics;
32
+ logger = new Logger(McpClientService_1.name);
33
+ constructor(env = new ProcessEnvReader(), metrics = new NoopMcpMetrics()) {
34
+ this.env = env;
35
+ this.metrics = metrics;
36
+ }
37
+ async listTools(rawUrl, config, options = {}) {
38
+ const startedAt = Date.now();
39
+ const { client, transport, transportKind, host } = await this.connect(rawUrl, config, options);
40
+ try {
41
+ const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
42
+ const result = await client.listTools(undefined, { timeout: timeoutMs, maxTotalTimeout: timeoutMs });
43
+ this.recordCall({
44
+ host,
45
+ transport: transportKind,
46
+ operation: 'listTools',
47
+ outcome: 'success',
48
+ latencyMs: Date.now() - startedAt,
49
+ });
50
+ return { tools: result.tools };
51
+ }
52
+ catch (e) {
53
+ const mapped = this.mapSdkError(e);
54
+ this.recordCall({
55
+ host,
56
+ transport: transportKind,
57
+ operation: 'listTools',
58
+ outcome: outcomeFor(mapped),
59
+ latencyMs: Date.now() - startedAt,
60
+ });
61
+ throw mapped;
62
+ }
63
+ finally {
64
+ await this.dispose(transport, transportKind);
65
+ }
66
+ }
67
+ async callTool(rawUrl, config, toolName, toolArgs, options = {}) {
68
+ const startedAt = Date.now();
69
+ const { client, transport, transportKind, host } = await this.connect(rawUrl, config, options);
70
+ try {
71
+ const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
72
+ const result = await client.callTool({ name: toolName, arguments: toolArgs }, undefined, {
73
+ timeout: timeoutMs,
74
+ maxTotalTimeout: timeoutMs,
75
+ });
76
+ this.recordCall({
77
+ host,
78
+ transport: transportKind,
79
+ operation: 'callTool',
80
+ toolName,
81
+ outcome: 'success',
82
+ latencyMs: Date.now() - startedAt,
83
+ });
84
+ if ('toolResult' in result && result.toolResult !== undefined) {
85
+ return {
86
+ kind: 'legacyToolResult',
87
+ toolResult: result.toolResult,
88
+ meta: result._meta,
89
+ };
90
+ }
91
+ return {
92
+ kind: 'callToolResult',
93
+ content: result.content,
94
+ structuredContent: result.structuredContent,
95
+ isError: result.isError,
96
+ meta: result._meta,
97
+ };
98
+ }
99
+ catch (e) {
100
+ const mapped = this.mapSdkError(e);
101
+ this.recordCall({
102
+ host,
103
+ transport: transportKind,
104
+ operation: 'callTool',
105
+ toolName,
106
+ outcome: outcomeFor(mapped),
107
+ latencyMs: Date.now() - startedAt,
108
+ });
109
+ throw mapped;
110
+ }
111
+ finally {
112
+ await this.dispose(transport, transportKind);
113
+ }
114
+ }
115
+ mergeHeaders(config, url) {
116
+ const out = {};
117
+ if (config.defaultHeaders) {
118
+ for (const [header, value] of Object.entries(config.defaultHeaders)) {
119
+ out[header.toLowerCase()] = value;
120
+ }
121
+ }
122
+ if (config.headerEnv) {
123
+ this.applyEnvMap(out, config.headerEnv);
124
+ }
125
+ if (config.hostHeaderEnv) {
126
+ const wildcard = config.hostHeaderEnv['*'];
127
+ if (wildcard)
128
+ this.applyEnvMap(out, wildcard);
129
+ const host = url.hostname;
130
+ const hostMap = config.hostHeaderEnv[host];
131
+ if (hostMap && hostMap !== wildcard)
132
+ this.applyEnvMap(out, hostMap);
133
+ }
134
+ return out;
135
+ }
136
+ applyEnvMap(into, map) {
137
+ for (const [header, envKey] of Object.entries(map)) {
138
+ const v = this.env.get(envKey);
139
+ if (v !== undefined)
140
+ into[header.toLowerCase()] = v;
141
+ }
142
+ }
143
+ async connect(rawUrl, config, options) {
144
+ const startedAt = Date.now();
145
+ let url;
146
+ try {
147
+ url = await assertMcpUrlSafe(rawUrl, config.allowedHosts, config.allowInsecureHttp ?? false, {
148
+ skipDnsResolution: options.skipDnsResolution,
149
+ allowPrivateHosts: config.allowPrivateHosts ?? false,
150
+ });
151
+ }
152
+ catch (e) {
153
+ const transportKind = options.transport ?? 'streamableHttp';
154
+ const host = safeHost(rawUrl);
155
+ this.recordConnect({
156
+ host,
157
+ transport: transportKind,
158
+ outcome: 'security',
159
+ latencyMs: Date.now() - startedAt,
160
+ });
161
+ throw e instanceof McpUrlSecurityError ? e : new McpUrlSecurityError(asMessage(e));
162
+ }
163
+ const transportKind = options.transport ?? 'streamableHttp';
164
+ const headers = this.mergeHeaders(config, url);
165
+ const headerNames = Object.keys(headers);
166
+ this.logger.debug(`mcp.connect host=${url.hostname} transport=${transportKind} headers=[${headerNames.join(',')}]`);
167
+ const client = new Client(CLIENT_INFO, {});
168
+ const controller = new AbortController();
169
+ const innerTimeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
170
+ const outerMs = innerTimeoutMs * OUTER_TIMEOUT_MULTIPLIER + OUTER_TIMEOUT_BUFFER_MS;
171
+ const abortTimer = setTimeout(() => controller.abort(), outerMs);
172
+ let transport;
173
+ try {
174
+ const requestInit = { headers: new Headers(headers), signal: controller.signal };
175
+ transport =
176
+ transportKind === 'sse'
177
+ ? new SSEClientTransport(url, { requestInit })
178
+ : new StreamableHTTPClientTransport(url, { requestInit });
179
+ await client.connect(transport);
180
+ this.recordConnect({
181
+ host: url.hostname,
182
+ transport: transportKind,
183
+ outcome: 'success',
184
+ latencyMs: Date.now() - startedAt,
185
+ });
186
+ return { client, transport, transportKind, host: url.hostname };
187
+ }
188
+ catch (e) {
189
+ if (transport)
190
+ await transport.close().catch(() => undefined);
191
+ const mapped = this.mapSdkError(e);
192
+ this.recordConnect({
193
+ host: url.hostname,
194
+ transport: transportKind,
195
+ outcome: outcomeFor(mapped),
196
+ latencyMs: Date.now() - startedAt,
197
+ });
198
+ throw mapped;
199
+ }
200
+ finally {
201
+ clearTimeout(abortTimer);
202
+ }
203
+ }
204
+ async dispose(transport, transportKind) {
205
+ try {
206
+ if (transportKind === 'streamableHttp' && transport.terminateSession) {
207
+ await transport.terminateSession().catch(() => undefined);
208
+ }
209
+ }
210
+ finally {
211
+ await transport.close().catch(() => undefined);
212
+ }
213
+ }
214
+ mapSdkError(e) {
215
+ if (e instanceof McpUrlSecurityError)
216
+ return e;
217
+ if (e instanceof McpAuthError)
218
+ return e;
219
+ if (e instanceof McpTimeoutError)
220
+ return e;
221
+ if (e instanceof McpProtocolError)
222
+ return e;
223
+ if (e instanceof McpTransportError)
224
+ return e;
225
+ const msg = asMessage(e);
226
+ if (e instanceof Error && (e.name === 'AbortError' || e.name === 'TimeoutError')) {
227
+ return new McpTimeoutError(`MCP request timed out: ${msg}`);
228
+ }
229
+ const status = httpStatusFrom(e);
230
+ if (status === 401 || status === 403) {
231
+ return new McpAuthError(`MCP authentication failed: ${msg}`);
232
+ }
233
+ const jsonRpcCode = jsonRpcCodeFrom(e);
234
+ if (jsonRpcCode === -32700 || jsonRpcCode === -32600) {
235
+ return new McpProtocolError(`MCP protocol error: ${msg}`);
236
+ }
237
+ return new McpTransportError(`MCP transport error: ${msg}`);
238
+ }
239
+ recordConnect(sample) {
240
+ this.logger.log(`mcp.connect.done host=${sample.host} transport=${sample.transport} outcome=${sample.outcome} latencyMs=${sample.latencyMs}`);
241
+ try {
242
+ this.metrics.recordConnect(sample);
243
+ }
244
+ catch {
245
+ }
246
+ }
247
+ recordCall(sample) {
248
+ const tn = sample.toolName ? ` toolName=${sample.toolName}` : '';
249
+ this.logger.log(`mcp.${sample.operation} host=${sample.host} transport=${sample.transport}${tn} outcome=${sample.outcome} latencyMs=${sample.latencyMs}`);
250
+ try {
251
+ this.metrics.recordCall(sample);
252
+ }
253
+ catch {
254
+ }
255
+ }
256
+ };
257
+ McpClientService = McpClientService_1 = __decorate([
258
+ Injectable(),
259
+ __param(0, Optional()),
260
+ __param(0, Inject(MCP_ENV_READER)),
261
+ __param(1, Optional()),
262
+ __param(1, Inject(MCP_METRICS)),
263
+ __metadata("design:paramtypes", [Object, Object])
264
+ ], McpClientService);
265
+ export { McpClientService };
266
+ function asMessage(e) {
267
+ return e instanceof Error ? e.message : String(e);
268
+ }
269
+ function httpStatusFrom(e) {
270
+ if (!e || typeof e !== 'object')
271
+ return undefined;
272
+ const obj = e;
273
+ const direct = obj.status ?? obj.statusCode;
274
+ if (typeof direct === 'number' && Number.isInteger(direct))
275
+ return direct;
276
+ const response = obj.response;
277
+ if (response && typeof response === 'object') {
278
+ const nested = response.status;
279
+ if (typeof nested === 'number' && Number.isInteger(nested))
280
+ return nested;
281
+ }
282
+ return undefined;
283
+ }
284
+ function jsonRpcCodeFrom(e) {
285
+ if (!e || typeof e !== 'object')
286
+ return undefined;
287
+ const code = e.code;
288
+ return typeof code === 'number' && Number.isInteger(code) ? code : undefined;
289
+ }
290
+ function outcomeFor(e) {
291
+ if (e instanceof McpUrlSecurityError)
292
+ return 'security';
293
+ if (e instanceof McpAuthError)
294
+ return 'auth';
295
+ if (e instanceof McpTimeoutError)
296
+ return 'timeout';
297
+ if (e instanceof McpProtocolError)
298
+ return 'protocol';
299
+ return 'transport';
300
+ }
301
+ function safeHost(rawUrl) {
302
+ try {
303
+ return new URL(rawUrl).hostname || '<unknown>';
304
+ }
305
+ catch {
306
+ return '<invalid-url>';
307
+ }
308
+ }
309
+ //# sourceMappingURL=mcp-client.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-client.service.js","sourceRoot":"","sources":["../../src/services/mcp-client.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
2
+ import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
3
+ export type McpClientLike = Client;
4
+ export type McpTransportLike = Transport & {
5
+ terminateSession?: () => Promise<void>;
6
+ };
7
+ export type McpClientCtor = new (info: {
8
+ name: string;
9
+ version: string;
10
+ }, options?: Record<string, unknown>) => McpClientLike;
11
+ export type McpTransportCtor = new (url: URL, options?: {
12
+ requestInit?: RequestInit;
13
+ }) => McpTransportLike;
14
+ //# sourceMappingURL=mcp-sdk.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-sdk.types.d.ts","sourceRoot":"","sources":["../../src/services/mcp-sdk.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AACnC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG,KAC1B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,aAAa,CAAC;AAEnB,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,KAAK,gBAAgB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=mcp-sdk.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-sdk.types.js","sourceRoot":"","sources":["../../src/services/mcp-sdk.types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,26 @@
1
+ import type { McpTransportKind } from '../types.js';
2
+ export type McpCallOutcome = 'success' | 'auth' | 'timeout' | 'protocol' | 'transport' | 'security';
3
+ export interface McpConnectSample {
4
+ host: string;
5
+ transport: McpTransportKind;
6
+ outcome: McpCallOutcome;
7
+ latencyMs: number;
8
+ }
9
+ export interface McpCallSample {
10
+ host: string;
11
+ transport: McpTransportKind;
12
+ operation: 'listTools' | 'callTool';
13
+ toolName?: string;
14
+ outcome: McpCallOutcome;
15
+ latencyMs: number;
16
+ }
17
+ export interface McpMetricsPort {
18
+ recordConnect(sample: McpConnectSample): void;
19
+ recordCall(sample: McpCallSample): void;
20
+ }
21
+ export declare class NoopMcpMetrics implements McpMetricsPort {
22
+ recordConnect(): void;
23
+ recordCall(): void;
24
+ }
25
+ export declare const MCP_METRICS: unique symbol;
26
+ //# sourceMappingURL=metrics-port.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics-port.d.ts","sourceRoot":"","sources":["../../src/services/metrics-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,WAAW,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9C,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACzC;AAED,qBAAa,cAAe,YAAW,cAAc;IACnD,aAAa,IAAI,IAAI;IACrB,UAAU,IAAI,IAAI;CACnB;AAED,eAAO,MAAM,WAAW,eAAwB,CAAC"}
@@ -0,0 +1,6 @@
1
+ export class NoopMcpMetrics {
2
+ recordConnect() { }
3
+ recordCall() { }
4
+ }
5
+ export const MCP_METRICS = Symbol('MCP_METRICS');
6
+ //# sourceMappingURL=metrics-port.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metrics-port.js","sourceRoot":"","sources":["../../src/services/metrics-port.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,cAAc;IACzB,aAAa,KAAU,CAAC;IACxB,UAAU,KAAU,CAAC;CACtB;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './mcp-call.tool.js';
2
+ export * from './mcp-connection-args.schema.js';
3
+ export * from './mcp-list-tools.tool.js';
4
+ export * from './mcp-tool-base.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './mcp-call.tool.js';
2
+ export * from './mcp-connection-args.schema.js';
3
+ export * from './mcp-list-tools.tool.js';
4
+ export * from './mcp-tool-base.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}
@@ -0,0 +1,19 @@
1
+ import { z } from 'zod';
2
+ import { ToolCallOptions, ToolResult } from '@loopstack/common';
3
+ import type { McpToolConfig } from '../config/mcp-tool-config.schema.js';
4
+ import { McpToolBase } from './mcp-tool-base.js';
5
+ export declare const McpCallToolArgsSchema: z.ZodObject<{
6
+ serverUrl: z.ZodURL;
7
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
8
+ transport: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
9
+ streamableHttp: "streamableHttp";
10
+ sse: "sse";
11
+ }>>>;
12
+ toolName: z.ZodString;
13
+ arguments: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
14
+ }, z.core.$strict>;
15
+ export type McpCallToolArgs = z.infer<typeof McpCallToolArgsSchema>;
16
+ export declare class McpCallTool extends McpToolBase<McpCallToolArgs> {
17
+ call(args: McpCallToolArgs, options?: ToolCallOptions<McpToolConfig>): Promise<ToolResult>;
18
+ }
19
+ //# sourceMappingURL=mcp-call.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-call.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-call.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,qBAAqB;;;;;;;;;kBAGvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAQa,WAAY,SAAQ,WAAW,CAAC,eAAe,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAUjG"}
@@ -0,0 +1,36 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ import { z } from 'zod';
8
+ import { Tool } from '@loopstack/common';
9
+ import { McpToolConfigSchema } from '../config/mcp-tool-config.schema.js';
10
+ import { McpConnectionArgsSchema } from './mcp-connection-args.schema.js';
11
+ import { McpToolBase } from './mcp-tool-base.js';
12
+ export const McpCallToolArgsSchema = McpConnectionArgsSchema.extend({
13
+ toolName: z.string().min(1).describe('Name of the remote MCP tool to invoke.'),
14
+ arguments: z.record(z.string(), z.unknown()).optional().default({}).describe('JSON object passed to the tool.'),
15
+ }).strict();
16
+ let McpCallTool = class McpCallTool extends McpToolBase {
17
+ async call(args, options) {
18
+ const cfg = this.requireConfig(options?.config);
19
+ const result = await this.mcp.callTool(args.serverUrl, cfg, args.toolName, args.arguments, {
20
+ timeoutMs: args.timeoutMs,
21
+ transport: args.transport,
22
+ });
23
+ return { data: result };
24
+ }
25
+ };
26
+ McpCallTool = __decorate([
27
+ Tool({
28
+ uiConfig: {
29
+ description: 'Calls a tool on a remote MCP server over HTTPS (Streamable HTTP or legacy SSE). Requires `allowedHosts` and optional `headerEnv`/`hostHeaderEnv` via `@InjectTool`.',
30
+ },
31
+ schema: McpCallToolArgsSchema,
32
+ configSchema: McpToolConfigSchema,
33
+ })
34
+ ], McpCallTool);
35
+ export { McpCallTool };
36
+ //# sourceMappingURL=mcp-call.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-call.tool.js","sourceRoot":"","sources":["../../src/tools/mcp-call.tool.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAChH,CAAC,CAAC,MAAM,EAAE,CAAC;AAYL,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,WAA4B;IAC3D,KAAK,CAAC,IAAI,CAAC,IAAqB,EAAE,OAAwC;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;YACzF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF,CAAA;AAXY,WAAW;IARvB,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,qKAAqK;SACxK;QACD,MAAM,EAAE,qBAAqB;QAC7B,YAAY,EAAE,mBAAmB;KAClC,CAAC;GACW,WAAW,CAWvB"}
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+ export declare const McpConnectionArgsSchema: z.ZodObject<{
3
+ serverUrl: z.ZodURL;
4
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
5
+ transport: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
6
+ streamableHttp: "streamableHttp";
7
+ sse: "sse";
8
+ }>>>;
9
+ }, z.core.$strict>;
10
+ export type McpConnectionArgs = z.infer<typeof McpConnectionArgsSchema>;
11
+ //# sourceMappingURL=mcp-connection-args.schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-connection-args.schema.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-connection-args.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;kBAUzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { z } from 'zod';
2
+ export const McpConnectionArgsSchema = z
3
+ .object({
4
+ serverUrl: z.url().describe('MCP endpoint URL (https recommended).'),
5
+ timeoutMs: z.number().int().positive().max(900_000).optional().describe('Per-request timeout (ms).'),
6
+ transport: z
7
+ .enum(['streamableHttp', 'sse'])
8
+ .optional()
9
+ .default('streamableHttp')
10
+ .describe('Use `sse` only for legacy MCP servers that still expose SSE.'),
11
+ })
12
+ .strict();
13
+ //# sourceMappingURL=mcp-connection-args.schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-connection-args.schema.js","sourceRoot":"","sources":["../../src/tools/mcp-connection-args.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACpG,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;SAC/B,QAAQ,EAAE;SACV,OAAO,CAAC,gBAAgB,CAAC;SACzB,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;KACD,MAAM,EAAE,CAAC"}
@@ -0,0 +1,17 @@
1
+ import { z } from 'zod';
2
+ import { ToolCallOptions, ToolResult } from '@loopstack/common';
3
+ import type { McpToolConfig } from '../config/mcp-tool-config.schema.js';
4
+ import { McpToolBase } from './mcp-tool-base.js';
5
+ export declare const McpListToolsArgsSchema: z.ZodObject<{
6
+ serverUrl: z.ZodURL;
7
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
8
+ transport: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
9
+ streamableHttp: "streamableHttp";
10
+ sse: "sse";
11
+ }>>>;
12
+ }, z.core.$strict>;
13
+ export type McpListToolsArgs = z.infer<typeof McpListToolsArgsSchema>;
14
+ export declare class McpListToolsTool extends McpToolBase<McpListToolsArgs> {
15
+ call(args: McpListToolsArgs, options?: ToolCallOptions<McpToolConfig>): Promise<ToolResult>;
16
+ }
17
+ //# sourceMappingURL=mcp-list-tools.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-list-tools.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-list-tools.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;;;;kBAA0B,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,qBAQa,gBAAiB,SAAQ,WAAW,CAAC,gBAAgB,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAUlG"}
@@ -0,0 +1,32 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ import { Tool } from '@loopstack/common';
8
+ import { McpToolConfigSchema } from '../config/mcp-tool-config.schema.js';
9
+ import { McpConnectionArgsSchema } from './mcp-connection-args.schema.js';
10
+ import { McpToolBase } from './mcp-tool-base.js';
11
+ export const McpListToolsArgsSchema = McpConnectionArgsSchema;
12
+ let McpListToolsTool = class McpListToolsTool extends McpToolBase {
13
+ async call(args, options) {
14
+ const cfg = this.requireConfig(options?.config);
15
+ const result = await this.mcp.listTools(args.serverUrl, cfg, {
16
+ timeoutMs: args.timeoutMs,
17
+ transport: args.transport,
18
+ });
19
+ return { data: result };
20
+ }
21
+ };
22
+ McpListToolsTool = __decorate([
23
+ Tool({
24
+ uiConfig: {
25
+ description: 'Lists tool definitions exposed by a remote MCP server (Streamable HTTP or legacy SSE). Requires `allowedHosts` (and optional auth headers) via `@InjectTool`.',
26
+ },
27
+ schema: McpListToolsArgsSchema,
28
+ configSchema: McpToolConfigSchema,
29
+ })
30
+ ], McpListToolsTool);
31
+ export { McpListToolsTool };
32
+ //# sourceMappingURL=mcp-list-tools.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-list-tools.tool.js","sourceRoot":"","sources":["../../src/tools/mcp-list-tools.tool.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAYvD,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,WAA6B;IACjE,KAAK,CAAC,IAAI,CAAC,IAAsB,EAAE,OAAwC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,MAAiC,EAAE,CAAC;IACrD,CAAC;CACF,CAAA;AAXY,gBAAgB;IAR5B,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,+JAA+J;SAClK;QACD,MAAM,EAAE,sBAAsB;QAC9B,YAAY,EAAE,mBAAmB;KAClC,CAAC;GACW,gBAAgB,CAW5B"}
@@ -0,0 +1,8 @@
1
+ import { BaseTool } from '@loopstack/common';
2
+ import type { McpToolConfig } from '../config/mcp-tool-config.schema.js';
3
+ import { McpClientService } from '../services/mcp-client.service.js';
4
+ export declare abstract class McpToolBase<TArgs extends object> extends BaseTool<TArgs, McpToolConfig> {
5
+ protected readonly mcp: McpClientService;
6
+ protected requireConfig(config: McpToolConfig | undefined): McpToolConfig;
7
+ }
8
+ //# sourceMappingURL=mcp-tool-base.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-tool-base.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-tool-base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAMrE,8BAAsB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAE,SAAQ,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAClF,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAG,gBAAgB,CAAC;IAEpD,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa;CAM1E"}
@@ -0,0 +1,26 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ import { Inject } from '@nestjs/common';
11
+ import { BaseTool } from '@loopstack/common';
12
+ import { McpClientService } from '../services/mcp-client.service.js';
13
+ export class McpToolBase extends BaseTool {
14
+ mcp;
15
+ requireConfig(config) {
16
+ if (!config?.allowedHosts?.length) {
17
+ throw new Error(`${this.constructor.name} requires @InjectTool({ allowedHosts: [...] }) configuration.`);
18
+ }
19
+ return config;
20
+ }
21
+ }
22
+ __decorate([
23
+ Inject(),
24
+ __metadata("design:type", McpClientService)
25
+ ], McpToolBase.prototype, "mcp", void 0);
26
+ //# sourceMappingURL=mcp-tool-base.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-tool-base.js","sourceRoot":"","sources":["../../src/tools/mcp-tool-base.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAMrE,MAAM,OAAgB,WAAkC,SAAQ,QAA8B;IAC/D,GAAG,CAAoB;IAE1C,aAAa,CAAC,MAAiC;QACvD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,+DAA+D,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAR8B;IAA5B,MAAM,EAAE;8BAA0B,gBAAgB;wCAAC"}
@@ -0,0 +1,2 @@
1
+ export type McpTransportKind = 'streamableHttp' | 'sse';
2
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,KAAK,CAAC"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map