mcp-expose 1.1.0 → 1.1.2

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 (47) hide show
  1. package/CHANGELOG.md +33 -1
  2. package/README.md +143 -34
  3. package/dist/adonisjs/index.cjs +128 -6
  4. package/dist/adonisjs/index.cjs.map +1 -1
  5. package/dist/adonisjs/index.d.cts +1 -1
  6. package/dist/adonisjs/index.d.ts +1 -1
  7. package/dist/adonisjs/index.js +128 -6
  8. package/dist/adonisjs/index.js.map +1 -1
  9. package/dist/express/index.cjs +128 -6
  10. package/dist/express/index.cjs.map +1 -1
  11. package/dist/express/index.d.cts +1 -1
  12. package/dist/express/index.d.ts +1 -1
  13. package/dist/express/index.js +128 -6
  14. package/dist/express/index.js.map +1 -1
  15. package/dist/fastify/index.cjs +128 -6
  16. package/dist/fastify/index.cjs.map +1 -1
  17. package/dist/fastify/index.d.cts +1 -1
  18. package/dist/fastify/index.d.ts +1 -1
  19. package/dist/fastify/index.js +128 -6
  20. package/dist/fastify/index.js.map +1 -1
  21. package/dist/hono/index.cjs +128 -6
  22. package/dist/hono/index.cjs.map +1 -1
  23. package/dist/hono/index.d.cts +1 -1
  24. package/dist/hono/index.d.ts +1 -1
  25. package/dist/hono/index.js +128 -6
  26. package/dist/hono/index.js.map +1 -1
  27. package/dist/index.cjs +128 -31
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +7 -5
  30. package/dist/index.d.ts +7 -5
  31. package/dist/index.js +128 -31
  32. package/dist/index.js.map +1 -1
  33. package/dist/koa/index.cjs +128 -6
  34. package/dist/koa/index.cjs.map +1 -1
  35. package/dist/koa/index.d.cts +1 -1
  36. package/dist/koa/index.d.ts +1 -1
  37. package/dist/koa/index.js +128 -6
  38. package/dist/koa/index.js.map +1 -1
  39. package/dist/nestjs/index.cjs +128 -6
  40. package/dist/nestjs/index.cjs.map +1 -1
  41. package/dist/nestjs/index.d.cts +1 -1
  42. package/dist/nestjs/index.d.ts +1 -1
  43. package/dist/nestjs/index.js +128 -6
  44. package/dist/nestjs/index.js.map +1 -1
  45. package/dist/{server-BFQ_Hdh9.d.cts → server--mQVQq3A.d.cts} +55 -2
  46. package/dist/{server-BRw1E2xy.d.ts → server-BPDTsT2o.d.ts} +55 -2
  47. package/package.json +2 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/core/dispatch.ts","../../src/core/marker.ts","../../src/core/schema.ts","../../src/core/route-tool.ts","../../src/core/oauth.ts","../../src/core/server.ts","../../src/hono/index.ts"],"sourcesContent":["import type { Dispatcher, RouteRequest, ToolContext } from './types.js';\n\nexport function buildUrl(base: string, req: Pick<RouteRequest, 'path' | 'query'>): string {\n const url = new URL(base.replace(/\\/+$/, '') + req.path);\n for (const [k, v] of Object.entries(req.query)) {\n for (const item of Array.isArray(v) ? v : [v]) url.searchParams.append(k, item);\n }\n return url.toString();\n}\n\nexport interface FetchDispatcherOptions {\n /**\n * Base URL of the API, e.g. `http://127.0.0.1:3000` or `https://api.example.com/v1`.\n * A function lets adapters resolve it per call (e.g. from the local port).\n */\n baseUrl: string | ((ctx: ToolContext) => string);\n /** Custom fetch implementation. Defaults to the global `fetch`. */\n fetch?: typeof fetch;\n /** Per-request timeout in ms. @default 30_000 */\n timeoutMs?: number;\n}\n\n/**\n * Dispatches tool calls as real HTTP requests. Used for loopback calls into the\n * host app (Express, Koa, NestJS) and for standalone gateways in front of any API.\n */\nexport function createFetchDispatcher(opts: FetchDispatcherOptions): Dispatcher {\n const doFetch = opts.fetch ?? fetch;\n return async (req, ctx) => {\n const base = typeof opts.baseUrl === 'function' ? opts.baseUrl(ctx) : opts.baseUrl;\n const res = await doFetch(buildUrl(base, req), {\n method: req.method,\n headers: req.headers,\n body:\n req.body === undefined || req.method === 'GET' || req.method === 'HEAD' ? undefined : JSON.stringify(req.body),\n signal: AbortSignal.timeout(opts.timeoutMs ?? 30_000),\n });\n const headers: Record<string, string> = {};\n res.headers.forEach((v, k) => (headers[k] = v));\n return { status: res.status, headers, body: await res.text() };\n };\n}\n","import type { RouteToolOptions } from './types.js';\n\n/** Symbol under which marker middleware carries its tool options. */\nexport const MCP_TOOL = Symbol.for('mcp-expose.tool');\n\nexport type Marked<T> = T & { [MCP_TOOL]: RouteToolOptions };\n\nexport function markerOf(fn: unknown): RouteToolOptions | undefined {\n return typeof fn === 'function' ? (fn as Partial<Marked<object>>)[MCP_TOOL] : undefined;\n}\n\nexport function mark<T extends object>(fn: T, opts: RouteToolOptions): Marked<T> {\n Object.defineProperty(fn, MCP_TOOL, { value: opts, enumerable: false });\n return fn as Marked<T>;\n}\n","import type { JsonSchema, McpToolDefinition, SchemaLike } from './types.js';\n\ninterface StandardSchemaV1 {\n '~standard': {\n validate?: (value: unknown) => unknown;\n jsonSchema?: { input?: (opts: { target: string }) => unknown };\n };\n}\n\nfunction isStandard(s: unknown): s is StandardSchemaV1 {\n return typeof s === 'object' && s !== null && '~standard' in s;\n}\n\n/** Convert any supported schema flavour into a plain JSON Schema object. */\nexport function toJsonSchema(schema: SchemaLike | undefined): JsonSchema | undefined {\n if (schema === undefined || schema === null) return undefined;\n let out: unknown;\n if (isStandard(schema) && typeof schema['~standard'].jsonSchema?.input === 'function') {\n out = schema['~standard'].jsonSchema.input({ target: 'draft-2020-12' });\n } else if (typeof (schema as { toJSONSchema?: unknown }).toJSONSchema === 'function') {\n out = (schema as { toJSONSchema(): unknown }).toJSONSchema();\n } else if (isStandard(schema)) {\n throw new Error(\n 'mcp-expose: this schema library does not support JSON Schema export. Pass a plain JSON Schema instead.',\n );\n } else {\n out = schema;\n }\n const { $schema: _ignored, ...rest } = out as JsonSchema;\n return rest;\n}\n\n/** Build a validator from a Standard Schema, if the input is one. */\nexport function toValidator(schema: SchemaLike | undefined): McpToolDefinition['validate'] {\n if (!isStandard(schema) || typeof schema['~standard'].validate !== 'function') return undefined;\n const validate = schema['~standard'].validate;\n return async (value) => {\n const result = (await validate(value)) as {\n value?: unknown;\n issues?: { message: string; path?: (PropertyKey | { key: PropertyKey })[] }[];\n };\n if (!result.issues) return { ok: true, value: result.value };\n const message = result.issues\n .map((i) => {\n const path = (i.path ?? []).map((p) => (typeof p === 'object' ? String(p.key) : String(p))).join('.');\n return path ? `${path}: ${i.message}` : i.message;\n })\n .join('; ');\n return { ok: false, message };\n };\n}\n\n/** Very small structural check used when no Standard Schema validator exists. */\nexport function checkRequired(schema: JsonSchema, args: Record<string, unknown>): string | undefined {\n const missing = (schema.required ?? []).filter((k) => args[k] === undefined);\n return missing.length ? `Missing required argument(s): ${missing.join(', ')}` : undefined;\n}\n","import { checkRequired, toJsonSchema, toValidator } from './schema.js';\nimport type {\n Dispatcher,\n JsonSchema,\n McpServerOptions,\n McpToolDefinition,\n RouteResponse,\n RouteSpec,\n RouteToolOptions,\n ToolAnnotations,\n ToolContext,\n ToolResult,\n} from './types.js';\n\nexport const DEFAULT_FORWARD_HEADERS = ['authorization', 'cookie', 'x-api-key', 'accept-language'];\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);\nconst PARAM_RE = /:([A-Za-z0-9_]+)\\??|\\{([A-Za-z0-9_]+)\\}/g;\n\n/** Names of the path parameters in a route path (`/a/:id/{slug}` -> ['id', 'slug']). */\nexport function pathParams(path: string): string[] {\n return [...path.matchAll(PARAM_RE)].map((m) => (m[1] ?? m[2]) as string);\n}\n\n/**\n * Encode one path-parameter value. Rejects empty, `.` and `..` values: after URL\n * normalisation they would change which route is called (e.g. `/orders/../admin`),\n * letting an agent reach routes that were never exposed as tools.\n */\nfunction encodeSegment(name: string, value: unknown): string {\n const raw = String(value);\n if (raw === '' || raw === '.' || raw === '..') {\n throw new Error(`Invalid value for path parameter \"${name}\": ${JSON.stringify(raw)}`);\n }\n return encodeURIComponent(raw);\n}\n\n/** Replace path placeholders with URL-encoded values. Missing optional params drop their segment. */\nexport function interpolatePath(path: string, values: Record<string, unknown>): string {\n return path\n .replace(/\\/:([A-Za-z0-9_]+)\\?/g, (_, k: string) =>\n values[k] === undefined ? '' : `/${encodeSegment(k, values[k])}`,\n )\n .replace(PARAM_RE, (_, a?: string, b?: string) => {\n const k = (a ?? b) as string;\n return encodeSegment(k, values[k]);\n });\n}\n\n/** Join path segments, normalising slashes. */\nexport function joinPaths(...parts: (string | undefined)[]): string {\n const joined = parts\n .filter((p): p is string => !!p && p !== '/')\n .map((p) => p.replace(/^\\/+|\\/+$/g, ''))\n .filter(Boolean)\n .join('/');\n return `/${joined}`;\n}\n\n/** `GET /users/:id/orders` -> `get_users_by_id_orders` */\nexport function toolNameFromRoute(method: string, path: string): string {\n const segments = path\n .split('/')\n .filter(Boolean)\n .map((s) => {\n const m = /^(?::([A-Za-z0-9_]+)\\??|\\{([A-Za-z0-9_]+)\\})$/.exec(s);\n return m ? `by_${m[1] ?? m[2]}` : s;\n });\n return sanitizeToolName([method.toLowerCase(), ...segments].join('_'));\n}\n\nexport function sanitizeToolName(name: string): string {\n return name\n .replace(/[^A-Za-z0-9_-]+/g, '_')\n .replace(/_+/g, '_')\n .replace(/^_|_$/g, '')\n .slice(0, 64);\n}\n\nfunction defaultAnnotations(method: string): ToolAnnotations {\n switch (method) {\n case 'GET':\n case 'HEAD':\n return { readOnlyHint: true, openWorldHint: false };\n case 'DELETE':\n return { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false };\n case 'PUT':\n return { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };\n default:\n return { readOnlyHint: false, destructiveHint: false, openWorldHint: false };\n }\n}\n\ninterface ArgMapping {\n params: string[];\n query: Set<string>;\n body: Set<string>;\n /** Body schema is not an object: the whole body is passed under the `body` key. */\n wholeBody: boolean;\n bodyMethod: boolean;\n}\n\n/**\n * Build the flat input schema an agent sees, and remember which argument goes\n * to the path, query string or body when the tool is called.\n */\nexport function buildInputSchema(\n route: RouteSpec,\n opts: RouteToolOptions,\n): { schema: JsonSchema; mapping: ArgMapping } {\n const method = route.method.toUpperCase();\n const params = pathParams(route.path);\n const mapping: ArgMapping = {\n params,\n query: new Set(),\n body: new Set(),\n wholeBody: false,\n bodyMethod: BODY_METHODS.has(method),\n };\n\n if (opts.input) {\n const schema = toJsonSchema(opts.input) as JsonSchema;\n return { schema: { type: 'object', ...schema }, mapping };\n }\n\n const properties: Record<string, JsonSchema> = {};\n const required = new Set<string>();\n\n const paramSchema = toJsonSchema(opts.params);\n for (const p of params) {\n properties[p] = paramSchema?.properties?.[p] ?? { type: 'string', description: `Path parameter \"${p}\"` };\n if (!route.path.includes(`:${p}?`)) required.add(p);\n }\n\n const querySchema = toJsonSchema(opts.query);\n for (const [k, v] of Object.entries(querySchema?.properties ?? {})) {\n properties[k] = v;\n mapping.query.add(k);\n }\n for (const k of querySchema?.required ?? []) required.add(k);\n\n const bodySchema = toJsonSchema(opts.body);\n if (bodySchema) {\n if (bodySchema.properties && (bodySchema.type === undefined || bodySchema.type === 'object')) {\n for (const [k, v] of Object.entries(bodySchema.properties)) {\n properties[k] = v;\n mapping.body.add(k);\n }\n for (const k of bodySchema.required ?? []) required.add(k);\n } else {\n properties.body = bodySchema;\n required.add('body');\n mapping.wholeBody = true;\n }\n }\n\n const schema: JsonSchema = { type: 'object', properties };\n if (required.size) schema.required = [...required];\n return { schema, mapping };\n}\n\nfunction splitArgs(args: Record<string, unknown>, mapping: ArgMapping) {\n const pathValues: Record<string, unknown> = {};\n const query: Record<string, string | string[]> = {};\n let body: Record<string, unknown> | unknown | undefined;\n\n for (const [k, v] of Object.entries(args)) {\n if (v === undefined) continue;\n if (mapping.params.includes(k)) {\n pathValues[k] = v;\n } else if (mapping.wholeBody && k === 'body') {\n body = v;\n } else if (mapping.query.has(k) || (!mapping.body.has(k) && !mapping.bodyMethod)) {\n query[k] = Array.isArray(v) ? v.map(String) : typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v);\n } else {\n body = { ...((body as Record<string, unknown>) ?? {}), [k]: v };\n }\n }\n if (body === undefined && mapping.bodyMethod) body = {};\n return { pathValues, query, body };\n}\n\nexport function responseToResult(res: RouteResponse, maxChars: number): ToolResult {\n let text = res.body;\n if (text.length > maxChars) text = `${text.slice(0, maxChars)}\\n…[truncated ${text.length - maxChars} chars]`;\n const isError = res.status >= 400;\n const result: ToolResult = {\n content: [{ type: 'text', text: isError ? `HTTP ${res.status}\\n${text}` : text || `HTTP ${res.status}` }],\n };\n if (isError) {\n result.isError = true;\n return result;\n }\n if ((res.headers['content-type'] ?? '').includes('json') && text === res.body) {\n try {\n const parsed = JSON.parse(res.body);\n if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) result.structuredContent = parsed;\n } catch {\n /* not JSON after all */\n }\n }\n return result;\n}\n\nexport function pickForwardHeaders(ctx: ToolContext, names: string[]): Record<string, string> {\n const out: Record<string, string> = {};\n for (const name of names) {\n const v = ctx.headers[name.toLowerCase()];\n if (v !== undefined) out[name.toLowerCase()] = v;\n }\n return out;\n}\n\n/**\n * Turn an HTTP route + options into an MCP tool whose handler calls the route\n * through `dispatch`, so auth guards, validation and rate limits all still apply.\n */\nexport function createRouteTool(\n route: RouteSpec,\n opts: RouteToolOptions,\n dispatch: Dispatcher,\n serverOpts: Pick<McpServerOptions, 'forwardHeaders' | 'maxResponseChars'> = {},\n): McpToolDefinition {\n const method = route.method.toUpperCase();\n const name = sanitizeToolName(opts.name ?? toolNameFromRoute(method, route.path));\n const { schema, mapping } = buildInputSchema(route, opts);\n const forward = serverOpts.forwardHeaders ?? DEFAULT_FORWARD_HEADERS;\n const maxChars = serverOpts.maxResponseChars ?? 100_000;\n\n return {\n name,\n title: opts.title,\n description: opts.description ?? `${method} ${route.path}`,\n inputSchema: schema,\n annotations: { ...defaultAnnotations(method), ...opts.annotations },\n scopes: opts.scopes,\n validate: toValidator(opts.input),\n async handler(args, ctx) {\n const missing = opts.input ? undefined : checkRequired(schema, args);\n if (missing) return { isError: true, content: [{ type: 'text', text: missing }] };\n\n const { pathValues, query, body } = splitArgs(args, mapping);\n const headers: Record<string, string> = {\n accept: 'application/json',\n ...pickForwardHeaders(ctx, forward),\n ...opts.headers,\n 'x-mcp-tool': name,\n };\n if (ctx.clientIp) headers['x-forwarded-for'] = ctx.clientIp;\n if (body !== undefined) headers['content-type'] = 'application/json';\n\n let path: string;\n try {\n path = interpolatePath(route.path, pathValues);\n } catch (err) {\n return { isError: true, content: [{ type: 'text', text: (err as Error).message }] };\n }\n const res = await dispatch({ method, path, query, body, headers }, ctx);\n return responseToResult(res, maxChars);\n },\n };\n}\n","/**\n * OAuth 2.1 support per the MCP authorization spec: the MCP endpoint acts as an\n * OAuth *resource server*. It publishes Protected Resource Metadata (RFC 9728),\n * answers unauthenticated requests with a `WWW-Authenticate` challenge that\n * tells the client where to log in, and checks bearer tokens with a verifier\n * you provide (see `jwtVerifier` / `introspectionVerifier` in `mcp-expose/oauth`).\n *\n * Runtime-agnostic: no `node:*` imports.\n */\n\n/** Who the access token belongs to and what it allows. Available to tools as `ctx.auth`. */\nexport interface AuthInfo {\n /** The raw access token. */\n token: string;\n /** Scopes granted to the token. */\n scopes: string[];\n /** Subject (user id), e.g. the JWT `sub` claim. */\n subject?: string;\n /** OAuth client the token was issued to. */\n clientId?: string;\n /** Expiry, in seconds since the epoch. Expired tokens are rejected. */\n expiresAt?: number;\n /** All claims / introspection fields. */\n claims?: Record<string, unknown>;\n}\n\nexport interface VerifyTokenContext {\n /** The canonical resource URL (`oauth.resource`). Tokens must be issued for it (audience). */\n resource: string;\n /** Lower-cased headers of the MCP request. */\n headers: Record<string, string>;\n}\n\n/**\n * Checks an access token. Return its AuthInfo, or `undefined` / throw when the\n * token is invalid. It MUST check that the token was issued for this server\n * (audience = `ctx.resource`), or tokens meant for other services would be accepted.\n */\nexport type TokenVerifier = (\n token: string,\n ctx: VerifyTokenContext,\n) => AuthInfo | undefined | null | Promise<AuthInfo | undefined | null>;\n\nexport interface OAuthOptions {\n /**\n * Canonical, public URL of the MCP endpoint, e.g. `https://api.example.com/mcp`.\n * Clients request tokens for this resource, and it must match the URL they connect to.\n */\n resource: string;\n /** Issuer URLs of the authorization servers that issue tokens for this server. */\n authorizationServers: string[];\n /** Checks bearer tokens. */\n verifyToken: TokenVerifier;\n /** Scopes every token needs to use the MCP endpoint at all. */\n requiredScopes?: string[];\n /** Scopes advertised in the metadata. @default requiredScopes plus every tool's `scopes` */\n scopesSupported?: string[];\n /** Human-readable name shown by clients. */\n resourceName?: string;\n /** URL of documentation for developers. */\n resourceDocumentation?: string;\n /** Extra fields merged into the Protected Resource Metadata document. */\n metadata?: Record<string, unknown>;\n}\n\nexport const PROTECTED_RESOURCE_WELL_KNOWN = '/.well-known/oauth-protected-resource';\n\n/**\n * Paths the metadata is served on, per RFC 9728: the well-known prefix with the\n * resource path appended (`/.well-known/oauth-protected-resource/mcp`), plus the\n * bare well-known path that older clients fall back to.\n */\nexport function protectedResourceMetadataPaths(resource: string): string[] {\n const pathname = new URL(resource).pathname.replace(/\\/+$/, '');\n return pathname\n ? [PROTECTED_RESOURCE_WELL_KNOWN + pathname, PROTECTED_RESOURCE_WELL_KNOWN]\n : [PROTECTED_RESOURCE_WELL_KNOWN];\n}\n\n/** Absolute URL of the metadata document, used in `WWW-Authenticate`. */\nexport function protectedResourceMetadataUrl(resource: string): string {\n return new URL(protectedResourceMetadataPaths(resource)[0] as string, resource).href;\n}\n\nexport function validateOAuthOptions(o: OAuthOptions): void {\n let url: URL;\n try {\n url = new URL(o.resource);\n } catch {\n throw new Error(`mcp-expose: oauth.resource must be an absolute URL, got ${JSON.stringify(o.resource)}`);\n }\n if (url.hash) throw new Error('mcp-expose: oauth.resource must not contain a fragment');\n if (!o.authorizationServers?.length) throw new Error('mcp-expose: oauth.authorizationServers must not be empty');\n if (typeof o.verifyToken !== 'function') throw new Error('mcp-expose: oauth.verifyToken is required');\n}\n\nconst quote = (v: string) => `\"${v.replace(/[\"\\\\]/g, '\\\\$&')}\"`;\n\n/** Build a `WWW-Authenticate: Bearer ...` challenge (RFC 6750 + RFC 9728). */\nexport function bearerChallenge(\n resource: string,\n params: { error?: string; errorDescription?: string; scope?: string[] } = {},\n): string {\n const parts: string[] = [];\n if (params.error) parts.push(`error=${quote(params.error)}`);\n if (params.errorDescription) parts.push(`error_description=${quote(params.errorDescription)}`);\n if (params.scope?.length) parts.push(`scope=${quote(params.scope.join(' '))}`);\n parts.push(`resource_metadata=${quote(protectedResourceMetadataUrl(resource))}`);\n return `Bearer ${parts.join(', ')}`;\n}\n\n/** Extract the token from `Authorization: Bearer <token>`. Tokens in the query string are never accepted. */\nexport function bearerToken(headers: Record<string, string>): string | undefined {\n const m = /^Bearer[ ]+([^\\s,]+)\\s*$/i.exec(headers.authorization ?? '');\n return m?.[1];\n}\n\nexport type AuthOutcome =\n | { ok: true; auth: AuthInfo }\n | { ok: false; status: 401 | 403; challenge: string; error: string; description: string };\n\n/** Authenticate one MCP request. */\nexport async function authenticate(o: OAuthOptions, headers: Record<string, string>): Promise<AuthOutcome> {\n const token = bearerToken(headers);\n if (!token) {\n // No credentials: a bare challenge pointing at the metadata starts the client's login flow.\n return {\n ok: false,\n status: 401,\n error: 'unauthorized',\n description: 'Authorization required',\n challenge: bearerChallenge(o.resource, { scope: o.requiredScopes }),\n };\n }\n\n let auth: AuthInfo | undefined | null;\n try {\n auth = await o.verifyToken(token, { resource: o.resource, headers });\n } catch {\n auth = undefined;\n }\n if (!auth) return deny(o, 401, 'invalid_token', 'The access token is invalid');\n if (auth.expiresAt !== undefined && auth.expiresAt * 1000 <= Date.now()) {\n return deny(o, 401, 'invalid_token', 'The access token has expired');\n }\n const missing = missingScopes(auth, o.requiredScopes);\n if (missing.length) {\n // Keep the scopes already granted in the challenge, so re-authorizing never drops access.\n const scope = [...new Set([...(auth.scopes ?? []), ...(o.requiredScopes ?? [])])];\n return deny(o, 403, 'insufficient_scope', `Missing scope: ${missing.join(' ')}`, scope);\n }\n return { ok: true, auth: { ...auth, scopes: auth.scopes ?? [] } };\n}\n\n/** A failed AuthOutcome with an RFC 6750 error challenge. */\nexport function deny(\n o: OAuthOptions,\n status: 401 | 403,\n error: string,\n description: string,\n scope?: string[],\n): AuthOutcome & { ok: false } {\n return {\n ok: false,\n status,\n error,\n description,\n challenge: bearerChallenge(o.resource, { error, errorDescription: description, scope }),\n };\n}\n\nexport function missingScopes(auth: AuthInfo | undefined, required: string[] | undefined): string[] {\n if (!required?.length) return [];\n const granted = new Set(auth?.scopes ?? []);\n return required.filter((s) => !granted.has(s));\n}\n\n/** Parse a space-separated `scope` string or an array of scopes. */\nexport function parseScopes(value: unknown): string[] {\n if (Array.isArray(value)) return value.map(String);\n if (typeof value === 'string') return value.split(' ').filter(Boolean);\n return [];\n}\n","import { authenticate, deny, missingScopes, protectedResourceMetadataPaths, validateOAuthOptions } from './oauth.js';\nimport type { McpServerOptions, McpToolDefinition, ToolContext, ToolResult } from './types.js';\n\nexport const SUPPORTED_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];\nexport const LATEST_PROTOCOL_VERSION = SUPPORTED_PROTOCOL_VERSIONS[0] as string;\n\ntype JsonRpcId = string | number | null;\ninterface JsonRpcRequest {\n jsonrpc: '2.0';\n id?: JsonRpcId;\n method: string;\n params?: Record<string, unknown>;\n}\nexport interface JsonRpcResponse {\n jsonrpc: '2.0';\n id: JsonRpcId;\n result?: unknown;\n error?: { code: number; message: string; data?: unknown };\n}\n\nconst PARSE_ERROR = -32700;\nconst INVALID_REQUEST = -32600;\nconst METHOD_NOT_FOUND = -32601;\nconst INVALID_PARAMS = -32602;\n\nconst ok = (id: JsonRpcId, result: unknown): JsonRpcResponse => ({ jsonrpc: '2.0', id, result });\nconst fail = (id: JsonRpcId, code: number, message: string): JsonRpcResponse => ({\n jsonrpc: '2.0',\n id,\n error: { code, message },\n});\n\n/** Minimal HTTP request/response shapes, so each adapter can bridge its own framework. */\nexport interface McpHttpRequest {\n method: string;\n headers: Record<string, string>;\n /** Parsed JSON body, or the raw string. */\n body: unknown;\n}\nexport interface McpHttpResponse {\n status: number;\n headers: Record<string, string>;\n body?: string;\n}\n\n/**\n * A stateless MCP server speaking the Streamable HTTP transport (JSON responses).\n * Holds the tool registry and answers JSON-RPC messages.\n */\nexport class McpServer {\n private readonly tools = new Map<string, McpToolDefinition>();\n private loaders: (() => void | Promise<void>)[] = [];\n\n constructor(readonly options: McpServerOptions) {\n if (options.oauth) validateOAuthOptions(options.oauth);\n }\n\n /** Register a tool. Throws on duplicate names. */\n addTool(tool: McpToolDefinition): this {\n if (this.tools.has(tool.name)) {\n throw new Error(`mcp-expose: duplicate tool name \"${tool.name}\". Set an explicit \\`name\\`.`);\n }\n this.tools.set(tool.name, tool);\n return this;\n }\n\n /** Register a function that adds tools lazily, right before the first MCP request is served. */\n onLoad(loader: () => void | Promise<void>): this {\n this.loaders.push(loader);\n return this;\n }\n\n async listTools(): Promise<McpToolDefinition[]> {\n await this.load();\n return [...this.tools.values()];\n }\n\n private async load() {\n if (!this.loaders.length) return;\n const loaders = this.loaders;\n this.loaders = [];\n for (const l of loaders) await l();\n }\n\n /** Handle one JSON-RPC message (or a batch). Returns null when no response is due. */\n async handleMessage(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | JsonRpcResponse[] | null> {\n if (Array.isArray(message)) {\n const results = (await Promise.all(message.map((m) => this.handleOne(m, ctx)))).filter(\n (r): r is JsonRpcResponse => r !== null,\n );\n return results.length ? results : null;\n }\n return this.handleOne(message, ctx);\n }\n\n private async handleOne(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | null> {\n const msg = message as Partial<JsonRpcRequest>;\n if (!msg || typeof msg !== 'object' || msg.jsonrpc !== '2.0') {\n return fail(null, INVALID_REQUEST, 'Invalid JSON-RPC message');\n }\n // Responses from the client or notifications: acknowledge, no reply.\n if (typeof msg.method !== 'string' || msg.id === undefined) return null;\n const id = msg.id;\n const params = msg.params ?? {};\n\n await this.load();\n switch (msg.method) {\n case 'initialize': {\n const requested = params.protocolVersion as string | undefined;\n const protocolVersion =\n requested && SUPPORTED_PROTOCOL_VERSIONS.includes(requested) ? requested : LATEST_PROTOCOL_VERSION;\n return ok(id, {\n protocolVersion,\n capabilities: { tools: { listChanged: false } },\n serverInfo: { name: this.options.name, version: this.options.version ?? '1.0.0' },\n ...(this.options.instructions ? { instructions: this.options.instructions } : {}),\n });\n }\n case 'ping':\n return ok(id, {});\n case 'tools/list':\n return ok(id, {\n tools: [...this.tools.values()].map((t) => ({\n name: t.name,\n ...(t.title ? { title: t.title } : {}),\n description: t.description,\n inputSchema: t.inputSchema,\n ...(t.annotations ? { annotations: t.annotations } : {}),\n })),\n });\n case 'tools/call': {\n const tool = this.tools.get(params.name as string);\n if (!tool) return fail(id, INVALID_PARAMS, `Unknown tool: ${String(params.name)}`);\n return ok(id, await this.callTool(tool, (params.arguments ?? {}) as Record<string, unknown>, ctx));\n }\n case 'resources/list':\n return ok(id, { resources: [] });\n case 'prompts/list':\n return ok(id, { prompts: [] });\n default:\n return fail(id, METHOD_NOT_FOUND, `Method not found: ${msg.method}`);\n }\n }\n\n private async callTool(\n tool: McpToolDefinition,\n args: Record<string, unknown>,\n ctx: ToolContext,\n ): Promise<ToolResult> {\n try {\n if (tool.validate) {\n const v = await tool.validate(args);\n if (!v.ok) return { isError: true, content: [{ type: 'text', text: `Invalid arguments: ${v.message}` }] };\n args = v.value as Record<string, unknown>;\n }\n return await tool.handler(args, ctx);\n } catch (err) {\n // Tool failures are reported in-band so the model can react to them.\n return { isError: true, content: [{ type: 'text', text: `Tool error: ${(err as Error).message}` }] };\n }\n }\n\n /** Check the Origin header (DNS rebinding protection). */\n isOriginAllowed(origin: string | undefined): boolean {\n if (!origin) return true;\n const allowed = this.options.allowedOrigins;\n if (allowed === '*') return true;\n return (allowed ?? []).includes(origin);\n }\n\n /**\n * Paths on which adapters serve the OAuth Protected Resource Metadata\n * (empty when `oauth` is not configured). They must be public: no auth middleware.\n */\n get oauthMetadataPaths(): string[] {\n return this.options.oauth ? protectedResourceMetadataPaths(this.options.oauth.resource) : [];\n }\n\n /** The OAuth Protected Resource Metadata document (RFC 9728). */\n async protectedResourceMetadata(): Promise<Record<string, unknown>> {\n const o = this.options.oauth;\n if (!o) throw new Error('mcp-expose: the oauth option is not configured');\n await this.load();\n const scopes = o.scopesSupported ?? [\n ...new Set([...(o.requiredScopes ?? []), ...[...this.tools.values()].flatMap((t) => t.scopes ?? [])]),\n ];\n return {\n resource: o.resource,\n authorization_servers: o.authorizationServers,\n ...(scopes.length ? { scopes_supported: scopes } : {}),\n bearer_methods_supported: ['header'],\n ...(o.resourceName ? { resource_name: o.resourceName } : {}),\n ...(o.resourceDocumentation ? { resource_documentation: o.resourceDocumentation } : {}),\n ...o.metadata,\n };\n }\n\n /** HTTP handler for the metadata paths. Public and CORS-enabled so browser-based clients can read it. */\n async handleMetadataHttp(req: Pick<McpHttpRequest, 'method'>): Promise<McpHttpResponse> {\n const cors = { 'access-control-allow-origin': '*', 'access-control-allow-methods': 'GET, OPTIONS' };\n const method = req.method.toUpperCase();\n if (!this.options.oauth) return { status: 404, headers: {} };\n if (method === 'OPTIONS') return { status: 204, headers: { ...cors, 'access-control-allow-headers': '*' } };\n if (method !== 'GET' && method !== 'HEAD') return { status: 405, headers: { allow: 'GET, OPTIONS' } };\n const body = JSON.stringify(await this.protectedResourceMetadata());\n return {\n status: 200,\n headers: { ...cors, 'content-type': 'application/json', 'cache-control': 'public, max-age=3600' },\n body: method === 'HEAD' ? undefined : body,\n };\n }\n\n /**\n * Framework-neutral Streamable HTTP handler. Adapters convert their request\n * into McpHttpRequest, call this, and write the McpHttpResponse back.\n */\n async handleHttp(req: McpHttpRequest, ctx: ToolContext): Promise<McpHttpResponse> {\n const json = { 'content-type': 'application/json' };\n if (!this.isOriginAllowed(req.headers.origin)) {\n return { status: 403, headers: json, body: JSON.stringify(fail(null, INVALID_REQUEST, 'Origin not allowed')) };\n }\n const oauth = this.options.oauth;\n if (oauth) {\n const outcome = await authenticate(oauth, req.headers);\n if (!outcome.ok) return authError(outcome);\n ctx = { ...ctx, auth: outcome.auth };\n }\n if (req.method.toUpperCase() !== 'POST') {\n // Stateless server: no standalone SSE stream and no sessions to delete.\n return { status: 405, headers: { allow: 'POST' } };\n }\n let body = req.body;\n if (typeof body === 'string' || body instanceof Uint8Array) {\n try {\n body = JSON.parse(typeof body === 'string' ? body : new TextDecoder().decode(body));\n } catch {\n return { status: 400, headers: json, body: JSON.stringify(fail(null, PARSE_ERROR, 'Parse error')) };\n }\n }\n if (oauth) {\n // Per-tool scopes: answer 403 so the client can ask the user for more access (step-up).\n await this.load();\n const calls = (Array.isArray(body) ? body : [body]) as Partial<JsonRpcRequest>[];\n for (const m of calls) {\n if (m?.method !== 'tools/call') continue;\n const tool = this.tools.get(m.params?.name as string);\n const missing = missingScopes(ctx.auth, tool?.scopes);\n if (missing.length) {\n // Include the scopes already granted, so re-authorizing never drops access the user gave before.\n const scope = [\n ...new Set([...(ctx.auth?.scopes ?? []), ...(oauth.requiredScopes ?? []), ...(tool?.scopes ?? [])]),\n ];\n return authError(\n deny(oauth, 403, 'insufficient_scope', `Tool \"${tool!.name}\" needs scope: ${missing.join(' ')}`, scope),\n );\n }\n }\n }\n const response = await this.handleMessage(body, ctx);\n if (response === null) return { status: 202, headers: {} };\n return { status: 200, headers: json, body: JSON.stringify(response) };\n }\n}\n\nfunction authError(o: { status: number; challenge: string; error: string; description: string }): McpHttpResponse {\n return {\n status: o.status,\n headers: { 'content-type': 'application/json', 'www-authenticate': o.challenge },\n body: JSON.stringify({ error: o.error, error_description: o.description }),\n };\n}\n","import { buildUrl } from '../core/dispatch.js';\nimport { mark, markerOf } from '../core/marker.js';\nimport { createRouteTool } from '../core/route-tool.js';\nimport { McpServer } from '../core/server.js';\nimport type { Dispatcher, McpServerOptions, McpToolDefinition, RouteToolOptions, ToolContext } from '../core/types.js';\n\ninterface HonoContextLike {\n // Hono >= 3 wraps the request (`c.req.raw`); in Hono 2 `c.req` is the Request itself.\n req: { method: string; raw?: Request; header(): Record<string, string> };\n env?: unknown;\n}\ntype HonoMiddleware = (c: HonoContextLike, next: () => Promise<void>) => Promise<void | Response>;\n\ninterface HonoLike {\n routes: { method: string; path: string; handler: unknown }[];\n request(input: string, init?: RequestInit, env?: unknown): Response | Promise<Response>;\n all(path: string, handler: (c: HonoContextLike) => Promise<Response>): unknown;\n}\n\n/**\n * Mark a Hono route as an MCP tool:\n *\n * app.get('/users/:id', mcpTool({ description: 'Get a user' }), auth, (c) => ...)\n */\nexport function mcpTool(options: RouteToolOptions = {}): HonoMiddleware {\n return mark<HonoMiddleware>(async (_c, next) => {\n await next();\n }, options);\n}\n\nexport interface HonoMcpOptions extends McpServerOptions {\n /** Path of the MCP endpoint. @default '/mcp' */\n path?: string;\n routes?: (RouteToolOptions & { method: string; path: string })[];\n tools?: McpToolDefinition[];\n}\n\n/**\n * Add an MCP endpoint to a Hono app. Works on every Hono runtime (Node, Bun,\n * Deno, Cloudflare Workers). Tool calls use `app.request()`: in-process, with\n * all middleware applied. Call this AFTER defining your routes... or not:\n * discovery is lazy, on the first MCP request.\n */\nexport function mountMcp(app: HonoLike, options: HonoMcpOptions): McpServer {\n const path = options.path ?? '/mcp';\n const server = new McpServer(options);\n\n const dispatch: Dispatcher = async (req, ctx) => {\n const res = await app.request(\n buildUrl('http://localhost', req),\n {\n method: req.method,\n headers: req.headers,\n body: req.body === undefined ? undefined : JSON.stringify(req.body),\n },\n (ctx.raw as HonoContextLike | undefined)?.env,\n );\n const headers: Record<string, string> = {};\n res.headers.forEach((v, k) => (headers[k] = v));\n return { status: res.status, headers, body: await res.text() };\n };\n\n for (const t of options.tools ?? []) server.addTool(t);\n server.onLoad(() => {\n const seen = new Set<string>();\n for (const r of app.routes) {\n const marker = markerOf(r.handler);\n const key = `${r.method} ${r.path}`;\n if (!marker || seen.has(key) || r.method === 'ALL') continue;\n seen.add(key);\n server.addTool(createRouteTool({ method: r.method, path: r.path }, marker, dispatch, options));\n }\n for (const r of options.routes ?? []) server.addTool(createRouteTool(r, r, dispatch, options));\n });\n\n // `all` (not `on([...])`) works on every Hono major; non-POST methods get 405.\n app.all(path, async (c) => {\n const request = c.req.raw ?? (c.req as unknown as Request);\n const headers: Record<string, string> = {};\n request.headers.forEach((v, k) => (headers[k] = v));\n const ctx: ToolContext = { headers, raw: c };\n const body = c.req.method === 'POST' ? await request.text() : undefined;\n const out = await server.handleHttp({ method: c.req.method, headers, body }, ctx);\n return new Response(out.body ?? null, { status: out.status, headers: out.headers });\n });\n // OAuth Protected Resource Metadata (public).\n for (const p of server.oauthMetadataPaths) {\n app.all(p, async (c) => {\n const out = await server.handleMetadataHttp({ method: c.req.method });\n return new Response(out.body ?? null, { status: out.status, headers: out.headers });\n });\n }\n return server;\n}\n"],"mappings":"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","names":["buildUrl","base","req","url","URL","replace","path","k","v","Object","entries","query","item","Array","isArray","searchParams","append","toString","MCP_TOOL","Symbol","for","markerOf","fn","undefined","mark","opts","Object","defineProperty","value","enumerable","isStandard","s","toJsonSchema","schema","undefined","out","jsonSchema","input","target","toJSONSchema","Error","$schema","_ignored","rest","toValidator","validate","value","result","issues","ok","message","map","i","path","p","String","key","join","checkRequired","args","missing","required","filter","k","length","DEFAULT_FORWARD_HEADERS","BODY_METHODS","Set","PARAM_RE","pathParams","path","matchAll","map","m","encodeSegment","name","value","raw","String","Error","JSON","stringify","encodeURIComponent","interpolatePath","values","replace","_","k","undefined","a","b","toolNameFromRoute","method","path","segments","split","filter","Boolean","map","s","m","exec","sanitizeToolName","toLowerCase","join","name","replace","slice","defaultAnnotations","readOnlyHint","openWorldHint","destructiveHint","idempotentHint","buildInputSchema","route","opts","toUpperCase","params","pathParams","mapping","query","Set","body","wholeBody","bodyMethod","BODY_METHODS","has","input","schema","toJsonSchema","type","properties","required","paramSchema","p","description","includes","add","querySchema","k","v","Object","entries","bodySchema","undefined","size","splitArgs","args","pathValues","Array","isArray","String","JSON","stringify","responseToResult","res","maxChars","text","length","isError","status","result","content","headers","parsed","parse","structuredContent","pickForwardHeaders","ctx","names","out","createRouteTool","dispatch","serverOpts","forward","forwardHeaders","DEFAULT_FORWARD_HEADERS","maxResponseChars","title","inputSchema","annotations","scopes","validate","toValidator","handler","missing","checkRequired","accept","clientIp","interpolatePath","err","message","PROTECTED_RESOURCE_WELL_KNOWN","protectedResourceMetadataPaths","resource","pathname","URL","replace","protectedResourceMetadataUrl","href","validateOAuthOptions","o","url","Error","JSON","stringify","hash","authorizationServers","length","verifyToken","quote","v","bearerChallenge","params","parts","error","push","errorDescription","scope","join","bearerToken","headers","m","exec","authorization","authenticate","token","ok","status","description","challenge","requiredScopes","auth","undefined","deny","expiresAt","Date","now","missing","missingScopes","Set","scopes","required","granted","filter","s","has","SUPPORTED_PROTOCOL_VERSIONS","LATEST_PROTOCOL_VERSION","PARSE_ERROR","INVALID_REQUEST","METHOD_NOT_FOUND","INVALID_PARAMS","ok","id","result","jsonrpc","fail","code","message","error","McpServer","tools","Map","loaders","options","oauth","validateOAuthOptions","addTool","tool","has","name","Error","set","onLoad","loader","push","listTools","load","values","length","l","handleMessage","ctx","Array","isArray","results","Promise","all","map","m","handleOne","filter","r","msg","method","undefined","params","requested","protocolVersion","includes","capabilities","listChanged","serverInfo","version","instructions","t","title","description","inputSchema","annotations","get","String","callTool","arguments","resources","prompts","args","validate","v","isError","content","type","text","value","handler","err","isOriginAllowed","origin","allowed","allowedOrigins","oauthMetadataPaths","protectedResourceMetadataPaths","resource","protectedResourceMetadata","o","scopes","scopesSupported","Set","requiredScopes","flatMap","authorization_servers","authorizationServers","scopes_supported","bearer_methods_supported","resourceName","resource_name","resourceDocumentation","resource_documentation","metadata","handleMetadataHttp","req","cors","toUpperCase","status","headers","allow","body","JSON","stringify","handleHttp","json","outcome","authenticate","authError","auth","Uint8Array","parse","TextDecoder","decode","calls","missing","missingScopes","scope","deny","join","response","challenge","error_description","mcpTool","options","mark","_c","next","mountMcp","app","path","server","McpServer","dispatch","req","ctx","res","request","buildUrl","method","headers","body","undefined","JSON","stringify","raw","env","forEach","v","k","status","text","t","tools","addTool","onLoad","seen","Set","r","routes","marker","markerOf","handler","key","has","add","createRouteTool","all","c","out","handleHttp","Response","p","oauthMetadataPaths","handleMetadataHttp"]}
1
+ {"version":3,"sources":["../../src/core/dispatch.ts","../../src/core/marker.ts","../../src/core/result.ts","../../src/core/schema.ts","../../src/core/route-tool.ts","../../src/core/oauth.ts","../../src/core/server.ts","../../src/hono/index.ts"],"sourcesContent":["import type { Dispatcher, RouteRequest, ToolContext } from './types.js';\n\nexport function buildUrl(base: string, req: Pick<RouteRequest, 'path' | 'query'>): string {\n const url = new URL(base.replace(/\\/+$/, '') + req.path);\n for (const [k, v] of Object.entries(req.query)) {\n for (const item of Array.isArray(v) ? v : [v]) url.searchParams.append(k, item);\n }\n return url.toString();\n}\n\nexport interface FetchDispatcherOptions {\n /**\n * Base URL of the API, e.g. `http://127.0.0.1:3000` or `https://api.example.com/v1`.\n * A function lets adapters resolve it per call (e.g. from the local port).\n */\n baseUrl: string | ((ctx: ToolContext) => string);\n /** Custom fetch implementation. Defaults to the global `fetch`. */\n fetch?: typeof fetch;\n /** Per-request timeout in ms. @default 30_000 */\n timeoutMs?: number;\n}\n\n/**\n * Dispatches tool calls as real HTTP requests. Used for loopback calls into the\n * host app (Express, Koa, NestJS) and for standalone gateways in front of any API.\n */\nexport function createFetchDispatcher(opts: FetchDispatcherOptions): Dispatcher {\n const doFetch = opts.fetch ?? fetch;\n return async (req, ctx) => {\n const base = typeof opts.baseUrl === 'function' ? opts.baseUrl(ctx) : opts.baseUrl;\n const res = await doFetch(buildUrl(base, req), {\n method: req.method,\n headers: req.headers,\n body:\n req.body === undefined || req.method === 'GET' || req.method === 'HEAD' ? undefined : JSON.stringify(req.body),\n signal: AbortSignal.timeout(opts.timeoutMs ?? 30_000),\n });\n const headers: Record<string, string> = {};\n res.headers.forEach((v, k) => (headers[k] = v));\n return { status: res.status, headers, body: await res.text() };\n };\n}\n","import type { RouteToolOptions } from './types.js';\n\n/** Symbol under which marker middleware carries its tool options. */\nexport const MCP_TOOL = Symbol.for('mcp-expose.tool');\n\nexport type Marked<T> = T & { [MCP_TOOL]: RouteToolOptions };\n\nexport function markerOf(fn: unknown): RouteToolOptions | undefined {\n return typeof fn === 'function' ? (fn as Partial<Marked<object>>)[MCP_TOOL] : undefined;\n}\n\nexport function mark<T extends object>(fn: T, opts: RouteToolOptions): Marked<T> {\n Object.defineProperty(fn, MCP_TOOL, { value: opts, enumerable: false });\n return fn as Marked<T>;\n}\n","import type { ToolResult } from './types.js';\n\n/** A ToolResult: `{ content: [{ type: 'text', ... }, ...] }`. Plain data with a `content` array is not one. */\nexport function isToolResult(value: unknown): value is ToolResult {\n const content = (value as ToolResult | undefined)?.content;\n return (\n !!value &&\n typeof value === 'object' &&\n Array.isArray(content) &&\n content.length > 0 &&\n content.every((c) => !!c && typeof c === 'object' && typeof (c as { type?: unknown }).type === 'string')\n );\n}\n\n/** Turn a handler's return value (string, JSON value or ToolResult) into a ToolResult. */\nexport function toToolResult(value: unknown): ToolResult {\n if (isToolResult(value)) return value;\n if (typeof value === 'string') return { content: [{ type: 'text', text: value }] };\n const text = JSON.stringify(value ?? null);\n const result: ToolResult = { content: [{ type: 'text', text }] };\n if (value && typeof value === 'object' && !Array.isArray(value)) {\n result.structuredContent = value as Record<string, unknown>;\n }\n return result;\n}\n","import type { JsonSchema, McpToolDefinition, SchemaLike } from './types.js';\n\ninterface StandardSchemaV1 {\n '~standard': {\n validate?: (value: unknown) => unknown;\n jsonSchema?: { input?: (opts: { target: string }) => unknown };\n };\n}\n\nfunction isStandard(s: unknown): s is StandardSchemaV1 {\n return typeof s === 'object' && s !== null && '~standard' in s;\n}\n\n/** Convert any supported schema flavour into a plain JSON Schema object. */\nexport function toJsonSchema(schema: SchemaLike | undefined): JsonSchema | undefined {\n if (schema === undefined || schema === null) return undefined;\n let out: unknown;\n if (isStandard(schema) && typeof schema['~standard'].jsonSchema?.input === 'function') {\n out = schema['~standard'].jsonSchema.input({ target: 'draft-2020-12' });\n } else if (typeof (schema as { toJSONSchema?: unknown }).toJSONSchema === 'function') {\n out = (schema as { toJSONSchema(): unknown }).toJSONSchema();\n } else if (isStandard(schema)) {\n throw new Error(\n 'mcp-expose: this schema library does not support JSON Schema export. Pass a plain JSON Schema instead.',\n );\n } else {\n out = schema;\n }\n const { $schema: _ignored, ...rest } = out as JsonSchema;\n return rest;\n}\n\n/** Build a validator from a Standard Schema, if the input is one. */\nexport function toValidator(schema: SchemaLike | undefined): McpToolDefinition['validate'] {\n if (!isStandard(schema) || typeof schema['~standard'].validate !== 'function') return undefined;\n const validate = schema['~standard'].validate;\n return async (value) => {\n const result = (await validate(value)) as {\n value?: unknown;\n issues?: { message: string; path?: (PropertyKey | { key: PropertyKey })[] }[];\n };\n if (!result.issues) return { ok: true, value: result.value };\n const message = result.issues\n .map((i) => {\n const path = (i.path ?? []).map((p) => (typeof p === 'object' ? String(p.key) : String(p))).join('.');\n return path ? `${path}: ${i.message}` : i.message;\n })\n .join('; ');\n return { ok: false, message };\n };\n}\n\n/** Very small structural check used when no Standard Schema validator exists. */\nexport function checkRequired(schema: JsonSchema, args: Record<string, unknown>): string | undefined {\n const missing = (schema.required ?? []).filter((k) => args[k] === undefined);\n return missing.length ? `Missing required argument(s): ${missing.join(', ')}` : undefined;\n}\n","import { isToolResult, toToolResult } from './result.js';\nimport { checkRequired, toJsonSchema, toValidator } from './schema.js';\nimport type {\n Dispatcher,\n JsonSchema,\n McpServerOptions,\n McpToolDefinition,\n ResponseTransformContext,\n RouteRequest,\n RouteResponse,\n RouteToolResponse,\n RouteSpec,\n RouteToolOptions,\n ToolAnnotations,\n ToolContext,\n ToolResult,\n} from './types.js';\n\nexport const DEFAULT_FORWARD_HEADERS = ['authorization', 'cookie', 'x-api-key', 'accept-language'];\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);\nconst PARAM_RE = /:([A-Za-z0-9_]+)\\??|\\{([A-Za-z0-9_]+)\\}/g;\n\n/** Names of the path parameters in a route path (`/a/:id/{slug}` -> ['id', 'slug']). */\nexport function pathParams(path: string): string[] {\n return [...path.matchAll(PARAM_RE)].map((m) => (m[1] ?? m[2]) as string);\n}\n\n/**\n * Encode one path-parameter value. Rejects empty, `.` and `..` values: after URL\n * normalisation they would change which route is called (e.g. `/orders/../admin`),\n * letting an agent reach routes that were never exposed as tools.\n */\nfunction encodeSegment(name: string, value: unknown): string {\n const raw = String(value);\n if (raw === '' || raw === '.' || raw === '..') {\n throw new Error(`Invalid value for path parameter \"${name}\": ${JSON.stringify(raw)}`);\n }\n return encodeURIComponent(raw);\n}\n\n/** Replace path placeholders with URL-encoded values. Missing optional params drop their segment. */\nexport function interpolatePath(path: string, values: Record<string, unknown>): string {\n return path\n .replace(/\\/:([A-Za-z0-9_]+)\\?/g, (_, k: string) =>\n values[k] === undefined ? '' : `/${encodeSegment(k, values[k])}`,\n )\n .replace(PARAM_RE, (_, a?: string, b?: string) => {\n const k = (a ?? b) as string;\n return encodeSegment(k, values[k]);\n });\n}\n\n/** Join path segments, normalising slashes. */\nexport function joinPaths(...parts: (string | undefined)[]): string {\n const joined = parts\n .filter((p): p is string => !!p && p !== '/')\n .map((p) => p.replace(/^\\/+|\\/+$/g, ''))\n .filter(Boolean)\n .join('/');\n return `/${joined}`;\n}\n\n/** `GET /users/:id/orders` -> `get_users_by_id_orders` */\nexport function toolNameFromRoute(method: string, path: string): string {\n const segments = path\n .split('/')\n .filter(Boolean)\n .map((s) => {\n const m = /^(?::([A-Za-z0-9_]+)\\??|\\{([A-Za-z0-9_]+)\\})$/.exec(s);\n return m ? `by_${m[1] ?? m[2]}` : s;\n });\n return sanitizeToolName([method.toLowerCase(), ...segments].join('_'));\n}\n\nexport function sanitizeToolName(name: string): string {\n return name\n .replace(/[^A-Za-z0-9_-]+/g, '_')\n .replace(/_+/g, '_')\n .replace(/^_|_$/g, '')\n .slice(0, 64);\n}\n\nfunction defaultAnnotations(method: string): ToolAnnotations {\n switch (method) {\n case 'GET':\n case 'HEAD':\n return { readOnlyHint: true, openWorldHint: false };\n case 'DELETE':\n return { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false };\n case 'PUT':\n return { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };\n default:\n return { readOnlyHint: false, destructiveHint: false, openWorldHint: false };\n }\n}\n\ninterface ArgMapping {\n params: string[];\n query: Set<string>;\n body: Set<string>;\n /** Body schema is not an object: the whole body is passed under the `body` key. */\n wholeBody: boolean;\n bodyMethod: boolean;\n}\n\n/**\n * Build the flat input schema an agent sees, and remember which argument goes\n * to the path, query string or body when the tool is called.\n */\nexport function buildInputSchema(\n route: RouteSpec,\n opts: RouteToolOptions,\n): { schema: JsonSchema; mapping: ArgMapping } {\n const method = route.method.toUpperCase();\n const params = pathParams(route.path);\n const mapping: ArgMapping = {\n params,\n query: new Set(),\n body: new Set(),\n wholeBody: false,\n bodyMethod: BODY_METHODS.has(method),\n };\n\n if (opts.input) {\n const schema = toJsonSchema(opts.input) as JsonSchema;\n return { schema: { type: 'object', ...schema }, mapping };\n }\n\n const properties: Record<string, JsonSchema> = {};\n const required = new Set<string>();\n\n const paramSchema = toJsonSchema(opts.params);\n for (const p of params) {\n properties[p] = paramSchema?.properties?.[p] ?? { type: 'string', description: `Path parameter \"${p}\"` };\n if (!route.path.includes(`:${p}?`)) required.add(p);\n }\n\n const querySchema = toJsonSchema(opts.query);\n for (const [k, v] of Object.entries(querySchema?.properties ?? {})) {\n properties[k] = v;\n mapping.query.add(k);\n }\n for (const k of querySchema?.required ?? []) required.add(k);\n\n const bodySchema = toJsonSchema(opts.body);\n if (bodySchema) {\n if (bodySchema.properties && (bodySchema.type === undefined || bodySchema.type === 'object')) {\n for (const [k, v] of Object.entries(bodySchema.properties)) {\n properties[k] = v;\n mapping.body.add(k);\n }\n for (const k of bodySchema.required ?? []) required.add(k);\n } else {\n properties.body = bodySchema;\n required.add('body');\n mapping.wholeBody = true;\n }\n }\n\n const schema: JsonSchema = { type: 'object', properties };\n if (required.size) schema.required = [...required];\n return { schema, mapping };\n}\n\nfunction splitArgs(args: Record<string, unknown>, mapping: ArgMapping) {\n const pathValues: Record<string, unknown> = {};\n const query: Record<string, string | string[]> = {};\n let body: Record<string, unknown> | unknown | undefined;\n\n for (const [k, v] of Object.entries(args)) {\n if (v === undefined) continue;\n if (mapping.params.includes(k)) {\n pathValues[k] = v;\n } else if (mapping.wholeBody && k === 'body') {\n body = v;\n } else if (mapping.query.has(k) || (!mapping.body.has(k) && !mapping.bodyMethod)) {\n query[k] = Array.isArray(v) ? v.map(String) : typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v);\n } else {\n body = { ...((body as Record<string, unknown>) ?? {}), [k]: v };\n }\n }\n if (body === undefined && mapping.bodyMethod) body = {};\n return { pathValues, query, body };\n}\n\nexport function responseToResult(res: RouteResponse, maxChars: number): ToolResult {\n const text = truncate(res.body, maxChars);\n const isError = res.status >= 400;\n const result: ToolResult = {\n content: [{ type: 'text', text: isError ? `HTTP ${res.status}\\n${text}` : text || `HTTP ${res.status}` }],\n };\n if (isError) {\n result.isError = true;\n return result;\n }\n if ((res.headers['content-type'] ?? '').includes('json') && text === res.body) {\n try {\n const parsed = JSON.parse(res.body);\n if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) result.structuredContent = parsed;\n } catch {\n /* not JSON after all */\n }\n }\n return result;\n}\n\nfunction safeDecode(segment: string): string {\n try {\n return decodeURIComponent(segment);\n } catch {\n return segment;\n }\n}\n\nfunction truncate(text: string, maxChars: number): string {\n return text.length > maxChars ? `${text.slice(0, maxChars)}\\n…[truncated ${text.length - maxChars} chars]` : text;\n}\n\n/** Add the parsed JSON body (when the response is JSON) and an `ok` flag. */\nexport function toRouteToolResponse(res: RouteResponse): RouteToolResponse {\n let json: unknown;\n if ((res.headers['content-type'] ?? '').includes('json') && res.body) {\n try {\n json = JSON.parse(res.body);\n } catch {\n /* not JSON after all */\n }\n }\n return { ...res, json, ok: res.status < 400 };\n}\n\n/**\n * Turn what a `transformResponse` hook returned into the tool result. Plain values\n * keep the route's error status; ToolResults are used as they are. Text is capped\n * at `maxChars` either way.\n */\nfunction transformedResult(value: unknown, res: RouteToolResponse, maxChars: number): ToolResult {\n const explicit = isToolResult(value);\n const result = toToolResult(value);\n if (!explicit && !res.ok) {\n result.isError = true;\n delete result.structuredContent;\n }\n let truncated = false;\n const content = result.content.map((c) => {\n if (c.type !== 'text' || c.text.length <= maxChars) return c;\n truncated = true;\n return { ...c, text: truncate(c.text, maxChars) };\n });\n if (!truncated) return result;\n // The text no longer matches the structured data, so only keep the text.\n const { structuredContent: _dropped, ...rest } = result;\n return { ...rest, content };\n}\n\nexport function pickForwardHeaders(ctx: ToolContext, names: string[]): Record<string, string> {\n const out: Record<string, string> = {};\n for (const name of names) {\n const v = ctx.headers[name.toLowerCase()];\n if (v !== undefined) out[name.toLowerCase()] = v;\n }\n return out;\n}\n\n/**\n * Turn an HTTP route + options into an MCP tool whose handler calls the route\n * through `dispatch`, so auth guards, validation and rate limits all still apply.\n */\nexport function createRouteTool(\n route: RouteSpec,\n opts: RouteToolOptions,\n dispatch: Dispatcher,\n serverOpts: Pick<McpServerOptions, 'forwardHeaders' | 'maxResponseChars' | 'transformResponse'> = {},\n): McpToolDefinition {\n const method = route.method.toUpperCase();\n const name = sanitizeToolName(opts.name ?? toolNameFromRoute(method, route.path));\n const { schema, mapping } = buildInputSchema(route, opts);\n const forward = serverOpts.forwardHeaders ?? DEFAULT_FORWARD_HEADERS;\n const maxChars = serverOpts.maxResponseChars ?? 100_000;\n const transform = opts.transformResponse ?? serverOpts.transformResponse;\n\n return {\n name,\n title: opts.title,\n description: opts.description ?? `${method} ${route.path}`,\n inputSchema: schema,\n annotations: { ...defaultAnnotations(method), ...opts.annotations },\n scopes: opts.scopes,\n validate: toValidator(opts.input),\n async handler(args, ctx) {\n const missing = opts.input ? undefined : checkRequired(schema, args);\n if (missing) return { isError: true, content: [{ type: 'text', text: missing }] };\n\n const { pathValues, query, body } = splitArgs(args, mapping);\n const headers: Record<string, string> = {\n accept: 'application/json',\n ...pickForwardHeaders(ctx, forward),\n ...opts.headers,\n 'x-mcp-tool': name,\n };\n if (ctx.clientIp) headers['x-forwarded-for'] = ctx.clientIp;\n if (body !== undefined) headers['content-type'] = 'application/json';\n\n let path: string;\n try {\n path = interpolatePath(route.path, pathValues);\n } catch (err) {\n return { isError: true, content: [{ type: 'text', text: (err as Error).message }] };\n }\n const request: RouteRequest = { method, path, query, body, headers };\n const res = await dispatch(request, ctx);\n if (!transform) return responseToResult(res, maxChars);\n\n const { 'content-type': _ct, ...baseHeaders } = headers;\n const hookCtx: ResponseTransformContext = {\n tool: name,\n args,\n request,\n toolContext: ctx,\n defaultResult: () => responseToResult(res, maxChars),\n async callRoute(r) {\n if (!r.path.startsWith('/')) {\n throw new Error(`callRoute: path must start with \"/\", got ${JSON.stringify(r.path)}`);\n }\n // Placeholders are encoded like tool arguments; dot segments are never allowed.\n const params = r.params ?? {};\n const missing = pathParams(r.path).filter((p) => params[p] === undefined && !r.path.includes(`:${p}?`));\n if (missing.length) throw new Error(`callRoute: missing params for ${r.path}: ${missing.join(', ')}`);\n const subPath = interpolatePath(r.path, params);\n if (subPath.split('/').some((seg) => ['.', '..'].includes(safeDecode(seg)))) {\n throw new Error(`callRoute: path must not contain \".\" or \"..\" segments: ${JSON.stringify(subPath)}`);\n }\n const sub: RouteRequest = {\n method: (r.method ?? 'GET').toUpperCase(),\n path: subPath,\n query: r.query ?? {},\n body: r.body,\n headers: { ...baseHeaders, ...r.headers },\n };\n if (sub.body !== undefined) sub.headers['content-type'] = 'application/json';\n return toRouteToolResponse(await dispatch(sub, ctx));\n },\n };\n const response = toRouteToolResponse(res);\n const value = await transform(response, hookCtx);\n return value === undefined ? responseToResult(res, maxChars) : transformedResult(value, response, maxChars);\n },\n };\n}\n","/**\n * OAuth 2.1 support per the MCP authorization spec: the MCP endpoint acts as an\n * OAuth *resource server*. It publishes Protected Resource Metadata (RFC 9728),\n * answers unauthenticated requests with a `WWW-Authenticate` challenge that\n * tells the client where to log in, and checks bearer tokens with a verifier\n * you provide (see `jwtVerifier` / `introspectionVerifier` in `mcp-expose/oauth`).\n *\n * Runtime-agnostic: no `node:*` imports.\n */\n\n/** Who the access token belongs to and what it allows. Available to tools as `ctx.auth`. */\nexport interface AuthInfo {\n /** The raw access token. */\n token: string;\n /** Scopes granted to the token. */\n scopes: string[];\n /** Subject (user id), e.g. the JWT `sub` claim. */\n subject?: string;\n /** OAuth client the token was issued to. */\n clientId?: string;\n /** Expiry, in seconds since the epoch. Expired tokens are rejected. */\n expiresAt?: number;\n /** All claims / introspection fields. */\n claims?: Record<string, unknown>;\n}\n\nexport interface VerifyTokenContext {\n /** The canonical resource URL (`oauth.resource`). Tokens must be issued for it (audience). */\n resource: string;\n /** Lower-cased headers of the MCP request. */\n headers: Record<string, string>;\n}\n\n/**\n * Checks an access token. Return its AuthInfo, or `undefined` / throw when the\n * token is invalid. It MUST check that the token was issued for this server\n * (audience = `ctx.resource`), or tokens meant for other services would be accepted.\n */\nexport type TokenVerifier = (\n token: string,\n ctx: VerifyTokenContext,\n) => AuthInfo | undefined | null | Promise<AuthInfo | undefined | null>;\n\nexport interface OAuthOptions {\n /**\n * Canonical, public URL of the MCP endpoint, e.g. `https://api.example.com/mcp`.\n * Clients request tokens for this resource, and it must match the URL they connect to.\n */\n resource: string;\n /** Issuer URLs of the authorization servers that issue tokens for this server. */\n authorizationServers: string[];\n /** Checks bearer tokens. */\n verifyToken: TokenVerifier;\n /** Scopes every token needs to use the MCP endpoint at all. */\n requiredScopes?: string[];\n /** Scopes advertised in the metadata. @default requiredScopes plus every tool's `scopes` */\n scopesSupported?: string[];\n /** Human-readable name shown by clients. */\n resourceName?: string;\n /** URL of documentation for developers. */\n resourceDocumentation?: string;\n /** Extra fields merged into the Protected Resource Metadata document. */\n metadata?: Record<string, unknown>;\n}\n\nexport const PROTECTED_RESOURCE_WELL_KNOWN = '/.well-known/oauth-protected-resource';\n\n/**\n * Paths the metadata is served on, per RFC 9728: the well-known prefix with the\n * resource path appended (`/.well-known/oauth-protected-resource/mcp`), plus the\n * bare well-known path that older clients fall back to.\n */\nexport function protectedResourceMetadataPaths(resource: string): string[] {\n const pathname = new URL(resource).pathname.replace(/\\/+$/, '');\n return pathname\n ? [PROTECTED_RESOURCE_WELL_KNOWN + pathname, PROTECTED_RESOURCE_WELL_KNOWN]\n : [PROTECTED_RESOURCE_WELL_KNOWN];\n}\n\n/** Absolute URL of the metadata document, used in `WWW-Authenticate`. */\nexport function protectedResourceMetadataUrl(resource: string): string {\n return new URL(protectedResourceMetadataPaths(resource)[0] as string, resource).href;\n}\n\nexport function validateOAuthOptions(o: OAuthOptions): void {\n let url: URL;\n try {\n url = new URL(o.resource);\n } catch {\n throw new Error(`mcp-expose: oauth.resource must be an absolute URL, got ${JSON.stringify(o.resource)}`);\n }\n if (url.hash) throw new Error('mcp-expose: oauth.resource must not contain a fragment');\n if (!o.authorizationServers?.length) throw new Error('mcp-expose: oauth.authorizationServers must not be empty');\n if (typeof o.verifyToken !== 'function') throw new Error('mcp-expose: oauth.verifyToken is required');\n}\n\nconst quote = (v: string) => `\"${v.replace(/[\"\\\\]/g, '\\\\$&')}\"`;\n\n/** Build a `WWW-Authenticate: Bearer ...` challenge (RFC 6750 + RFC 9728). */\nexport function bearerChallenge(\n resource: string,\n params: { error?: string; errorDescription?: string; scope?: string[] } = {},\n): string {\n const parts: string[] = [];\n if (params.error) parts.push(`error=${quote(params.error)}`);\n if (params.errorDescription) parts.push(`error_description=${quote(params.errorDescription)}`);\n if (params.scope?.length) parts.push(`scope=${quote(params.scope.join(' '))}`);\n parts.push(`resource_metadata=${quote(protectedResourceMetadataUrl(resource))}`);\n return `Bearer ${parts.join(', ')}`;\n}\n\n/** Extract the token from `Authorization: Bearer <token>`. Tokens in the query string are never accepted. */\nexport function bearerToken(headers: Record<string, string>): string | undefined {\n const m = /^Bearer[ ]+([^\\s,]+)\\s*$/i.exec(headers.authorization ?? '');\n return m?.[1];\n}\n\nexport type AuthOutcome =\n | { ok: true; auth: AuthInfo }\n | { ok: false; status: 401 | 403; challenge: string; error: string; description: string };\n\n/** Authenticate one MCP request. */\nexport async function authenticate(o: OAuthOptions, headers: Record<string, string>): Promise<AuthOutcome> {\n const token = bearerToken(headers);\n if (!token) {\n // No credentials: a bare challenge pointing at the metadata starts the client's login flow.\n return {\n ok: false,\n status: 401,\n error: 'unauthorized',\n description: 'Authorization required',\n challenge: bearerChallenge(o.resource, { scope: o.requiredScopes }),\n };\n }\n\n let auth: AuthInfo | undefined | null;\n try {\n auth = await o.verifyToken(token, { resource: o.resource, headers });\n } catch {\n auth = undefined;\n }\n if (!auth) return deny(o, 401, 'invalid_token', 'The access token is invalid');\n if (auth.expiresAt !== undefined && auth.expiresAt * 1000 <= Date.now()) {\n return deny(o, 401, 'invalid_token', 'The access token has expired');\n }\n const missing = missingScopes(auth, o.requiredScopes);\n if (missing.length) {\n // Keep the scopes already granted in the challenge, so re-authorizing never drops access.\n const scope = [...new Set([...(auth.scopes ?? []), ...(o.requiredScopes ?? [])])];\n return deny(o, 403, 'insufficient_scope', `Missing scope: ${missing.join(' ')}`, scope);\n }\n return { ok: true, auth: { ...auth, scopes: auth.scopes ?? [] } };\n}\n\n/** A failed AuthOutcome with an RFC 6750 error challenge. */\nexport function deny(\n o: OAuthOptions,\n status: 401 | 403,\n error: string,\n description: string,\n scope?: string[],\n): AuthOutcome & { ok: false } {\n return {\n ok: false,\n status,\n error,\n description,\n challenge: bearerChallenge(o.resource, { error, errorDescription: description, scope }),\n };\n}\n\nexport function missingScopes(auth: AuthInfo | undefined, required: string[] | undefined): string[] {\n if (!required?.length) return [];\n const granted = new Set(auth?.scopes ?? []);\n return required.filter((s) => !granted.has(s));\n}\n\n/** Parse a space-separated `scope` string or an array of scopes. */\nexport function parseScopes(value: unknown): string[] {\n if (Array.isArray(value)) return value.map(String);\n if (typeof value === 'string') return value.split(' ').filter(Boolean);\n return [];\n}\n","import { authenticate, deny, missingScopes, protectedResourceMetadataPaths, validateOAuthOptions } from './oauth.js';\nimport type { McpServerOptions, McpToolDefinition, ToolContext, ToolResult } from './types.js';\n\nexport const SUPPORTED_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];\nexport const LATEST_PROTOCOL_VERSION = SUPPORTED_PROTOCOL_VERSIONS[0] as string;\n\ntype JsonRpcId = string | number | null;\ninterface JsonRpcRequest {\n jsonrpc: '2.0';\n id?: JsonRpcId;\n method: string;\n params?: Record<string, unknown>;\n}\nexport interface JsonRpcResponse {\n jsonrpc: '2.0';\n id: JsonRpcId;\n result?: unknown;\n error?: { code: number; message: string; data?: unknown };\n}\n\nconst PARSE_ERROR = -32700;\nconst INVALID_REQUEST = -32600;\nconst METHOD_NOT_FOUND = -32601;\nconst INVALID_PARAMS = -32602;\n\nconst ok = (id: JsonRpcId, result: unknown): JsonRpcResponse => ({ jsonrpc: '2.0', id, result });\nconst fail = (id: JsonRpcId, code: number, message: string): JsonRpcResponse => ({\n jsonrpc: '2.0',\n id,\n error: { code, message },\n});\n\n/** Minimal HTTP request/response shapes, so each adapter can bridge its own framework. */\nexport interface McpHttpRequest {\n method: string;\n headers: Record<string, string>;\n /** Parsed JSON body, or the raw string. */\n body: unknown;\n}\nexport interface McpHttpResponse {\n status: number;\n headers: Record<string, string>;\n body?: string;\n}\n\n/**\n * A stateless MCP server speaking the Streamable HTTP transport (JSON responses).\n * Holds the tool registry and answers JSON-RPC messages.\n */\nexport class McpServer {\n private readonly tools = new Map<string, McpToolDefinition>();\n private loaders: (() => void | Promise<void>)[] = [];\n\n constructor(readonly options: McpServerOptions) {\n if (options.oauth) validateOAuthOptions(options.oauth);\n }\n\n /** Register a tool. Throws on duplicate names. */\n addTool(tool: McpToolDefinition): this {\n if (this.tools.has(tool.name)) {\n throw new Error(`mcp-expose: duplicate tool name \"${tool.name}\". Set an explicit \\`name\\`.`);\n }\n this.tools.set(tool.name, tool);\n return this;\n }\n\n /** Register a function that adds tools lazily, right before the first MCP request is served. */\n onLoad(loader: () => void | Promise<void>): this {\n this.loaders.push(loader);\n return this;\n }\n\n async listTools(): Promise<McpToolDefinition[]> {\n await this.load();\n return [...this.tools.values()];\n }\n\n private async load() {\n if (!this.loaders.length) return;\n const loaders = this.loaders;\n this.loaders = [];\n for (const l of loaders) await l();\n }\n\n /** Handle one JSON-RPC message (or a batch). Returns null when no response is due. */\n async handleMessage(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | JsonRpcResponse[] | null> {\n if (Array.isArray(message)) {\n const results = (await Promise.all(message.map((m) => this.handleOne(m, ctx)))).filter(\n (r): r is JsonRpcResponse => r !== null,\n );\n return results.length ? results : null;\n }\n return this.handleOne(message, ctx);\n }\n\n private async handleOne(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | null> {\n const msg = message as Partial<JsonRpcRequest>;\n if (!msg || typeof msg !== 'object' || msg.jsonrpc !== '2.0') {\n return fail(null, INVALID_REQUEST, 'Invalid JSON-RPC message');\n }\n // Responses from the client or notifications: acknowledge, no reply.\n if (typeof msg.method !== 'string' || msg.id === undefined) return null;\n const id = msg.id;\n const params = msg.params ?? {};\n\n await this.load();\n switch (msg.method) {\n case 'initialize': {\n const requested = params.protocolVersion as string | undefined;\n const protocolVersion =\n requested && SUPPORTED_PROTOCOL_VERSIONS.includes(requested) ? requested : LATEST_PROTOCOL_VERSION;\n return ok(id, {\n protocolVersion,\n capabilities: { tools: { listChanged: false } },\n serverInfo: { name: this.options.name, version: this.options.version ?? '1.0.0' },\n ...(this.options.instructions ? { instructions: this.options.instructions } : {}),\n });\n }\n case 'ping':\n return ok(id, {});\n case 'tools/list':\n return ok(id, {\n tools: [...this.tools.values()].map((t) => ({\n name: t.name,\n ...(t.title ? { title: t.title } : {}),\n description: t.description,\n inputSchema: t.inputSchema,\n ...(t.annotations ? { annotations: t.annotations } : {}),\n })),\n });\n case 'tools/call': {\n const tool = this.tools.get(params.name as string);\n if (!tool) return fail(id, INVALID_PARAMS, `Unknown tool: ${String(params.name)}`);\n return ok(id, await this.callTool(tool, (params.arguments ?? {}) as Record<string, unknown>, ctx));\n }\n case 'resources/list':\n return ok(id, { resources: [] });\n case 'prompts/list':\n return ok(id, { prompts: [] });\n default:\n return fail(id, METHOD_NOT_FOUND, `Method not found: ${msg.method}`);\n }\n }\n\n private async callTool(\n tool: McpToolDefinition,\n args: Record<string, unknown>,\n ctx: ToolContext,\n ): Promise<ToolResult> {\n try {\n if (tool.validate) {\n const v = await tool.validate(args);\n if (!v.ok) return { isError: true, content: [{ type: 'text', text: `Invalid arguments: ${v.message}` }] };\n args = v.value as Record<string, unknown>;\n }\n return await tool.handler(args, ctx);\n } catch (err) {\n // Tool failures are reported in-band so the model can react to them.\n return { isError: true, content: [{ type: 'text', text: `Tool error: ${(err as Error).message}` }] };\n }\n }\n\n /** Check the Origin header (DNS rebinding protection). */\n isOriginAllowed(origin: string | undefined): boolean {\n if (!origin) return true;\n const allowed = this.options.allowedOrigins;\n if (allowed === '*') return true;\n return (allowed ?? []).includes(origin);\n }\n\n /**\n * Paths on which adapters serve the OAuth Protected Resource Metadata\n * (empty when `oauth` is not configured). They must be public: no auth middleware.\n */\n get oauthMetadataPaths(): string[] {\n return this.options.oauth ? protectedResourceMetadataPaths(this.options.oauth.resource) : [];\n }\n\n /** The OAuth Protected Resource Metadata document (RFC 9728). */\n async protectedResourceMetadata(): Promise<Record<string, unknown>> {\n const o = this.options.oauth;\n if (!o) throw new Error('mcp-expose: the oauth option is not configured');\n await this.load();\n const scopes = o.scopesSupported ?? [\n ...new Set([...(o.requiredScopes ?? []), ...[...this.tools.values()].flatMap((t) => t.scopes ?? [])]),\n ];\n return {\n resource: o.resource,\n authorization_servers: o.authorizationServers,\n ...(scopes.length ? { scopes_supported: scopes } : {}),\n bearer_methods_supported: ['header'],\n ...(o.resourceName ? { resource_name: o.resourceName } : {}),\n ...(o.resourceDocumentation ? { resource_documentation: o.resourceDocumentation } : {}),\n ...o.metadata,\n };\n }\n\n /** HTTP handler for the metadata paths. Public and CORS-enabled so browser-based clients can read it. */\n async handleMetadataHttp(req: Pick<McpHttpRequest, 'method'>): Promise<McpHttpResponse> {\n const cors = { 'access-control-allow-origin': '*', 'access-control-allow-methods': 'GET, OPTIONS' };\n const method = req.method.toUpperCase();\n if (!this.options.oauth) return { status: 404, headers: {} };\n if (method === 'OPTIONS') return { status: 204, headers: { ...cors, 'access-control-allow-headers': '*' } };\n if (method !== 'GET' && method !== 'HEAD') return { status: 405, headers: { allow: 'GET, OPTIONS' } };\n const body = JSON.stringify(await this.protectedResourceMetadata());\n return {\n status: 200,\n headers: { ...cors, 'content-type': 'application/json', 'cache-control': 'public, max-age=3600' },\n body: method === 'HEAD' ? undefined : body,\n };\n }\n\n /**\n * Framework-neutral Streamable HTTP handler. Adapters convert their request\n * into McpHttpRequest, call this, and write the McpHttpResponse back.\n */\n async handleHttp(req: McpHttpRequest, ctx: ToolContext): Promise<McpHttpResponse> {\n const json = { 'content-type': 'application/json' };\n if (!this.isOriginAllowed(req.headers.origin)) {\n return { status: 403, headers: json, body: JSON.stringify(fail(null, INVALID_REQUEST, 'Origin not allowed')) };\n }\n const oauth = this.options.oauth;\n if (oauth) {\n const outcome = await authenticate(oauth, req.headers);\n if (!outcome.ok) return authError(outcome);\n ctx = { ...ctx, auth: outcome.auth };\n }\n if (req.method.toUpperCase() !== 'POST') {\n // Stateless server: no standalone SSE stream and no sessions to delete.\n return { status: 405, headers: { allow: 'POST' } };\n }\n let body = req.body;\n if (typeof body === 'string' || body instanceof Uint8Array) {\n try {\n body = JSON.parse(typeof body === 'string' ? body : new TextDecoder().decode(body));\n } catch {\n return { status: 400, headers: json, body: JSON.stringify(fail(null, PARSE_ERROR, 'Parse error')) };\n }\n }\n if (oauth) {\n // Per-tool scopes: answer 403 so the client can ask the user for more access (step-up).\n await this.load();\n const calls = (Array.isArray(body) ? body : [body]) as Partial<JsonRpcRequest>[];\n for (const m of calls) {\n if (m?.method !== 'tools/call') continue;\n const tool = this.tools.get(m.params?.name as string);\n const missing = missingScopes(ctx.auth, tool?.scopes);\n if (missing.length) {\n // Include the scopes already granted, so re-authorizing never drops access the user gave before.\n const scope = [\n ...new Set([...(ctx.auth?.scopes ?? []), ...(oauth.requiredScopes ?? []), ...(tool?.scopes ?? [])]),\n ];\n return authError(\n deny(oauth, 403, 'insufficient_scope', `Tool \"${tool!.name}\" needs scope: ${missing.join(' ')}`, scope),\n );\n }\n }\n }\n const response = await this.handleMessage(body, ctx);\n if (response === null) return { status: 202, headers: {} };\n return { status: 200, headers: json, body: JSON.stringify(response) };\n }\n}\n\nfunction authError(o: { status: number; challenge: string; error: string; description: string }): McpHttpResponse {\n return {\n status: o.status,\n headers: { 'content-type': 'application/json', 'www-authenticate': o.challenge },\n body: JSON.stringify({ error: o.error, error_description: o.description }),\n };\n}\n","import { buildUrl } from '../core/dispatch.js';\nimport { mark, markerOf } from '../core/marker.js';\nimport { createRouteTool } from '../core/route-tool.js';\nimport { McpServer } from '../core/server.js';\nimport type { Dispatcher, McpServerOptions, McpToolDefinition, RouteToolOptions, ToolContext } from '../core/types.js';\n\ninterface HonoContextLike {\n // Hono >= 3 wraps the request (`c.req.raw`); in Hono 2 `c.req` is the Request itself.\n req: { method: string; raw?: Request; header(): Record<string, string> };\n env?: unknown;\n}\ntype HonoMiddleware = (c: HonoContextLike, next: () => Promise<void>) => Promise<void | Response>;\n\ninterface HonoLike {\n routes: { method: string; path: string; handler: unknown }[];\n request(input: string, init?: RequestInit, env?: unknown): Response | Promise<Response>;\n all(path: string, handler: (c: HonoContextLike) => Promise<Response>): unknown;\n}\n\n/**\n * Mark a Hono route as an MCP tool:\n *\n * app.get('/users/:id', mcpTool({ description: 'Get a user' }), auth, (c) => ...)\n */\nexport function mcpTool(options: RouteToolOptions = {}): HonoMiddleware {\n return mark<HonoMiddleware>(async (_c, next) => {\n await next();\n }, options);\n}\n\nexport interface HonoMcpOptions extends McpServerOptions {\n /** Path of the MCP endpoint. @default '/mcp' */\n path?: string;\n routes?: (RouteToolOptions & { method: string; path: string })[];\n tools?: McpToolDefinition[];\n}\n\n/**\n * Add an MCP endpoint to a Hono app. Works on every Hono runtime (Node, Bun,\n * Deno, Cloudflare Workers). Tool calls use `app.request()`: in-process, with\n * all middleware applied. Call this AFTER defining your routes... or not:\n * discovery is lazy, on the first MCP request.\n */\nexport function mountMcp(app: HonoLike, options: HonoMcpOptions): McpServer {\n const path = options.path ?? '/mcp';\n const server = new McpServer(options);\n\n const dispatch: Dispatcher = async (req, ctx) => {\n const res = await app.request(\n buildUrl('http://localhost', req),\n {\n method: req.method,\n headers: req.headers,\n body: req.body === undefined ? undefined : JSON.stringify(req.body),\n },\n (ctx.raw as HonoContextLike | undefined)?.env,\n );\n const headers: Record<string, string> = {};\n res.headers.forEach((v, k) => (headers[k] = v));\n return { status: res.status, headers, body: await res.text() };\n };\n\n for (const t of options.tools ?? []) server.addTool(t);\n server.onLoad(() => {\n const seen = new Set<string>();\n for (const r of app.routes) {\n const marker = markerOf(r.handler);\n const key = `${r.method} ${r.path}`;\n if (!marker || seen.has(key) || r.method === 'ALL') continue;\n seen.add(key);\n server.addTool(createRouteTool({ method: r.method, path: r.path }, marker, dispatch, options));\n }\n for (const r of options.routes ?? []) server.addTool(createRouteTool(r, r, dispatch, options));\n });\n\n // `all` (not `on([...])`) works on every Hono major; non-POST methods get 405.\n app.all(path, async (c) => {\n const request = c.req.raw ?? (c.req as unknown as Request);\n const headers: Record<string, string> = {};\n request.headers.forEach((v, k) => (headers[k] = v));\n const ctx: ToolContext = { headers, raw: c };\n const body = c.req.method === 'POST' ? await request.text() : undefined;\n const out = await server.handleHttp({ method: c.req.method, headers, body }, ctx);\n return new Response(out.body ?? null, { status: out.status, headers: out.headers });\n });\n // OAuth Protected Resource Metadata (public).\n for (const p of server.oauthMetadataPaths) {\n app.all(p, async (c) => {\n const out = await server.handleMetadataHttp({ method: c.req.method });\n return new Response(out.body ?? null, { status: out.status, headers: out.headers });\n });\n }\n return server;\n}\n"],"mappings":"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","names":["buildUrl","base","req","url","URL","replace","path","k","v","Object","entries","query","item","Array","isArray","searchParams","append","toString","MCP_TOOL","Symbol","for","markerOf","fn","undefined","mark","opts","Object","defineProperty","value","enumerable","isToolResult","value","content","Array","isArray","length","every","c","type","toToolResult","text","JSON","stringify","result","structuredContent","isStandard","s","toJsonSchema","schema","undefined","out","jsonSchema","input","target","toJSONSchema","Error","$schema","_ignored","rest","toValidator","validate","value","result","issues","ok","message","map","i","path","p","String","key","join","checkRequired","args","missing","required","filter","k","length","DEFAULT_FORWARD_HEADERS","BODY_METHODS","Set","PARAM_RE","pathParams","path","matchAll","map","m","encodeSegment","name","value","raw","String","Error","JSON","stringify","encodeURIComponent","interpolatePath","values","replace","_","k","undefined","a","b","toolNameFromRoute","method","path","segments","split","filter","Boolean","map","s","m","exec","sanitizeToolName","toLowerCase","join","name","replace","slice","defaultAnnotations","readOnlyHint","openWorldHint","destructiveHint","idempotentHint","buildInputSchema","route","opts","toUpperCase","params","pathParams","mapping","query","Set","body","wholeBody","bodyMethod","BODY_METHODS","has","input","schema","toJsonSchema","type","properties","required","paramSchema","p","description","includes","add","querySchema","k","v","Object","entries","bodySchema","undefined","size","splitArgs","args","pathValues","Array","isArray","String","JSON","stringify","responseToResult","res","maxChars","text","truncate","isError","status","result","content","headers","parsed","parse","structuredContent","safeDecode","segment","decodeURIComponent","length","toRouteToolResponse","json","ok","transformedResult","value","explicit","isToolResult","toToolResult","truncated","c","_dropped","rest","pickForwardHeaders","ctx","names","out","createRouteTool","dispatch","serverOpts","forward","forwardHeaders","DEFAULT_FORWARD_HEADERS","maxResponseChars","transform","transformResponse","title","inputSchema","annotations","scopes","validate","toValidator","handler","missing","checkRequired","accept","clientIp","interpolatePath","err","message","request","_ct","baseHeaders","hookCtx","tool","toolContext","defaultResult","callRoute","r","startsWith","Error","subPath","some","seg","sub","response","PROTECTED_RESOURCE_WELL_KNOWN","protectedResourceMetadataPaths","resource","pathname","URL","replace","protectedResourceMetadataUrl","href","validateOAuthOptions","o","url","Error","JSON","stringify","hash","authorizationServers","length","verifyToken","quote","v","bearerChallenge","params","parts","error","push","errorDescription","scope","join","bearerToken","headers","m","exec","authorization","authenticate","token","ok","status","description","challenge","requiredScopes","auth","undefined","deny","expiresAt","Date","now","missing","missingScopes","Set","scopes","required","granted","filter","s","has","SUPPORTED_PROTOCOL_VERSIONS","LATEST_PROTOCOL_VERSION","PARSE_ERROR","INVALID_REQUEST","METHOD_NOT_FOUND","INVALID_PARAMS","ok","id","result","jsonrpc","fail","code","message","error","McpServer","tools","Map","loaders","options","oauth","validateOAuthOptions","addTool","tool","has","name","Error","set","onLoad","loader","push","listTools","load","values","length","l","handleMessage","ctx","Array","isArray","results","Promise","all","map","m","handleOne","filter","r","msg","method","undefined","params","requested","protocolVersion","includes","capabilities","listChanged","serverInfo","version","instructions","t","title","description","inputSchema","annotations","get","String","callTool","arguments","resources","prompts","args","validate","v","isError","content","type","text","value","handler","err","isOriginAllowed","origin","allowed","allowedOrigins","oauthMetadataPaths","protectedResourceMetadataPaths","resource","protectedResourceMetadata","o","scopes","scopesSupported","Set","requiredScopes","flatMap","authorization_servers","authorizationServers","scopes_supported","bearer_methods_supported","resourceName","resource_name","resourceDocumentation","resource_documentation","metadata","handleMetadataHttp","req","cors","toUpperCase","status","headers","allow","body","JSON","stringify","handleHttp","json","outcome","authenticate","authError","auth","Uint8Array","parse","TextDecoder","decode","calls","missing","missingScopes","scope","deny","join","response","challenge","error_description","mcpTool","options","mark","_c","next","mountMcp","app","path","server","McpServer","dispatch","req","ctx","res","request","buildUrl","method","headers","body","undefined","JSON","stringify","raw","env","forEach","v","k","status","text","t","tools","addTool","onLoad","seen","Set","r","routes","marker","markerOf","handler","key","has","add","createRouteTool","all","c","out","handleHttp","Response","p","oauthMetadataPaths","handleMetadataHttp"]}
package/dist/index.cjs CHANGED
@@ -486,6 +486,38 @@ function authError(o) {
486
486
  }
487
487
  __name(authError, "authError");
488
488
 
489
+ // src/core/result.ts
490
+ function isToolResult(value) {
491
+ const content = value?.content;
492
+ return !!value && typeof value === "object" && Array.isArray(content) && content.length > 0 && content.every((c) => !!c && typeof c === "object" && typeof c.type === "string");
493
+ }
494
+ __name(isToolResult, "isToolResult");
495
+ function toToolResult(value) {
496
+ if (isToolResult(value)) return value;
497
+ if (typeof value === "string") return {
498
+ content: [
499
+ {
500
+ type: "text",
501
+ text: value
502
+ }
503
+ ]
504
+ };
505
+ const text = JSON.stringify(value ?? null);
506
+ const result = {
507
+ content: [
508
+ {
509
+ type: "text",
510
+ text
511
+ }
512
+ ]
513
+ };
514
+ if (value && typeof value === "object" && !Array.isArray(value)) {
515
+ result.structuredContent = value;
516
+ }
517
+ return result;
518
+ }
519
+ __name(toToolResult, "toToolResult");
520
+
489
521
  // src/core/schema.ts
490
522
  function isStandard(s) {
491
523
  return typeof s === "object" && s !== null && "~standard" in s;
@@ -706,9 +738,7 @@ function splitArgs(args, mapping) {
706
738
  }
707
739
  __name(splitArgs, "splitArgs");
708
740
  function responseToResult(res, maxChars) {
709
- let text = res.body;
710
- if (text.length > maxChars) text = `${text.slice(0, maxChars)}
711
- \u2026[truncated ${text.length - maxChars} chars]`;
741
+ const text = truncate(res.body, maxChars);
712
742
  const isError = res.status >= 400;
713
743
  const result = {
714
744
  content: [
@@ -733,6 +763,58 @@ ${text}` : text || `HTTP ${res.status}`
733
763
  return result;
734
764
  }
735
765
  __name(responseToResult, "responseToResult");
766
+ function safeDecode(segment) {
767
+ try {
768
+ return decodeURIComponent(segment);
769
+ } catch {
770
+ return segment;
771
+ }
772
+ }
773
+ __name(safeDecode, "safeDecode");
774
+ function truncate(text, maxChars) {
775
+ return text.length > maxChars ? `${text.slice(0, maxChars)}
776
+ \u2026[truncated ${text.length - maxChars} chars]` : text;
777
+ }
778
+ __name(truncate, "truncate");
779
+ function toRouteToolResponse(res) {
780
+ let json;
781
+ if ((res.headers["content-type"] ?? "").includes("json") && res.body) {
782
+ try {
783
+ json = JSON.parse(res.body);
784
+ } catch {
785
+ }
786
+ }
787
+ return {
788
+ ...res,
789
+ json,
790
+ ok: res.status < 400
791
+ };
792
+ }
793
+ __name(toRouteToolResponse, "toRouteToolResponse");
794
+ function transformedResult(value, res, maxChars) {
795
+ const explicit = isToolResult(value);
796
+ const result = toToolResult(value);
797
+ if (!explicit && !res.ok) {
798
+ result.isError = true;
799
+ delete result.structuredContent;
800
+ }
801
+ let truncated = false;
802
+ const content = result.content.map((c) => {
803
+ if (c.type !== "text" || c.text.length <= maxChars) return c;
804
+ truncated = true;
805
+ return {
806
+ ...c,
807
+ text: truncate(c.text, maxChars)
808
+ };
809
+ });
810
+ if (!truncated) return result;
811
+ const { structuredContent: _dropped, ...rest } = result;
812
+ return {
813
+ ...rest,
814
+ content
815
+ };
816
+ }
817
+ __name(transformedResult, "transformedResult");
736
818
  function pickForwardHeaders(ctx, names) {
737
819
  const out = {};
738
820
  for (const name of names) {
@@ -748,6 +830,7 @@ function createRouteTool(route, opts, dispatch, serverOpts = {}) {
748
830
  const { schema, mapping } = buildInputSchema(route, opts);
749
831
  const forward = serverOpts.forwardHeaders ?? DEFAULT_FORWARD_HEADERS;
750
832
  const maxChars = serverOpts.maxResponseChars ?? 1e5;
833
+ const transform = opts.transformResponse ?? serverOpts.transformResponse;
751
834
  return {
752
835
  name,
753
836
  title: opts.title,
@@ -793,14 +876,53 @@ function createRouteTool(route, opts, dispatch, serverOpts = {}) {
793
876
  ]
794
877
  };
795
878
  }
796
- const res = await dispatch({
879
+ const request = {
797
880
  method,
798
881
  path,
799
882
  query,
800
883
  body,
801
884
  headers
802
- }, ctx);
803
- return responseToResult(res, maxChars);
885
+ };
886
+ const res = await dispatch(request, ctx);
887
+ if (!transform) return responseToResult(res, maxChars);
888
+ const { "content-type": _ct, ...baseHeaders } = headers;
889
+ const hookCtx = {
890
+ tool: name,
891
+ args,
892
+ request,
893
+ toolContext: ctx,
894
+ defaultResult: /* @__PURE__ */ __name(() => responseToResult(res, maxChars), "defaultResult"),
895
+ async callRoute(r) {
896
+ if (!r.path.startsWith("/")) {
897
+ throw new Error(`callRoute: path must start with "/", got ${JSON.stringify(r.path)}`);
898
+ }
899
+ const params = r.params ?? {};
900
+ const missing2 = pathParams(r.path).filter((p) => params[p] === void 0 && !r.path.includes(`:${p}?`));
901
+ if (missing2.length) throw new Error(`callRoute: missing params for ${r.path}: ${missing2.join(", ")}`);
902
+ const subPath = interpolatePath(r.path, params);
903
+ if (subPath.split("/").some((seg) => [
904
+ ".",
905
+ ".."
906
+ ].includes(safeDecode(seg)))) {
907
+ throw new Error(`callRoute: path must not contain "." or ".." segments: ${JSON.stringify(subPath)}`);
908
+ }
909
+ const sub = {
910
+ method: (r.method ?? "GET").toUpperCase(),
911
+ path: subPath,
912
+ query: r.query ?? {},
913
+ body: r.body,
914
+ headers: {
915
+ ...baseHeaders,
916
+ ...r.headers
917
+ }
918
+ };
919
+ if (sub.body !== void 0) sub.headers["content-type"] = "application/json";
920
+ return toRouteToolResponse(await dispatch(sub, ctx));
921
+ }
922
+ };
923
+ const response = toRouteToolResponse(res);
924
+ const value = await transform(response, hookCtx);
925
+ return value === void 0 ? responseToResult(res, maxChars) : transformedResult(value, response, maxChars);
804
926
  }
805
927
  };
806
928
  }
@@ -859,31 +981,6 @@ function defineTool(opts) {
859
981
  };
860
982
  }
861
983
  __name(defineTool, "defineTool");
862
- function toToolResult(value) {
863
- if (value && typeof value === "object" && Array.isArray(value.content)) return value;
864
- if (typeof value === "string") return {
865
- content: [
866
- {
867
- type: "text",
868
- text: value
869
- }
870
- ]
871
- };
872
- const text = JSON.stringify(value ?? null);
873
- const result = {
874
- content: [
875
- {
876
- type: "text",
877
- text
878
- }
879
- ]
880
- };
881
- if (value && typeof value === "object" && !Array.isArray(value)) {
882
- result.structuredContent = value;
883
- }
884
- return result;
885
- }
886
- __name(toToolResult, "toToolResult");
887
984
  function toolsFromOpenApi(doc, dispatch, opts = {}) {
888
985
  const include = opts.include ?? (({ operation }) => !!operation["x-mcp"]);
889
986
  const methods = [