@mcpfn/auth 0.0.1

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.
package/README.md ADDED
@@ -0,0 +1,20 @@
1
+ # `@mcpfn/auth`
2
+
3
+ Web Standard OAuth resource-server support for MCP servers.
4
+
5
+ It publishes RFC 9728 protected-resource metadata, validates Bearer tokens through the official SDK's `OAuthTokenVerifier` contract, enforces token expiry, resource indicators, and scopes, and passes trusted `authInfo` into the McpFn HTTP transport. Authorization-code, PKCE, DCR, and token issuance remain the authorization server's responsibility.
6
+
7
+ ```ts
8
+ import { createOAuthResourceServerHandler } from "@mcpfn/auth";
9
+
10
+ const mcp = await server.createWebStandardHandler({ enableJsonResponse: true });
11
+ const fetch = createOAuthResourceServerHandler(mcp, {
12
+ resource: "https://api.example.com/mcp",
13
+ authorizationServers: ["https://login.example.com"],
14
+ scopesSupported: ["mcp:read"],
15
+ requiredScopes: ["mcp:read"],
16
+ verifier,
17
+ });
18
+ ```
19
+
20
+ Enterprise-managed authorization helpers advertise the stable ID-JAG grant profile in authorization-server metadata and build the request metadata used by supporting clients.
package/dist/index.cjs ADDED
@@ -0,0 +1,158 @@
1
+ 'use strict';
2
+
3
+ // src/enterprise.ts
4
+ var MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID = "io.modelcontextprotocol/enterprise-managed-authorization";
5
+ var MCP_ID_JAG_GRANT_PROFILE = "urn:ietf:params:oauth:grant-profile:id-jag";
6
+ function withEnterpriseManagedAuthorization(metadata) {
7
+ return {
8
+ ...metadata,
9
+ authorization_grant_profiles_supported: [
10
+ .../* @__PURE__ */ new Set([
11
+ ...metadata.authorization_grant_profiles_supported ?? [],
12
+ MCP_ID_JAG_GRANT_PROFILE
13
+ ])
14
+ ]
15
+ };
16
+ }
17
+ function enterpriseManagedAuthorizationClientMetadata() {
18
+ return {
19
+ "io.modelcontextprotocol/clientCapabilities": {
20
+ extensions: {
21
+ [MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID]: {}
22
+ }
23
+ }
24
+ };
25
+ }
26
+
27
+ // src/resource-server.ts
28
+ function normalizeResource(resource) {
29
+ const url = new URL(resource.toString());
30
+ url.hash = "";
31
+ return url;
32
+ }
33
+ function unique(values) {
34
+ return [...new Set(values.map((value) => new URL(value.toString()).toString()))].sort();
35
+ }
36
+ function protectedResourceMetadataUrl(resource) {
37
+ const normalized = normalizeResource(resource);
38
+ const path = normalized.pathname === "/" ? "" : normalized.pathname;
39
+ return new URL(`/.well-known/oauth-protected-resource${path}`, normalized.origin);
40
+ }
41
+ function createProtectedResourceMetadata(options) {
42
+ const resource = normalizeResource(options.resource);
43
+ if (!options.authorizationServers.length) {
44
+ throw new Error("At least one OAuth authorization server is required");
45
+ }
46
+ return {
47
+ ...options.extraMetadata,
48
+ resource: resource.toString(),
49
+ authorization_servers: unique(options.authorizationServers),
50
+ ...options.scopesSupported ? { scopes_supported: [...new Set(options.scopesSupported)].sort() } : {},
51
+ bearer_methods_supported: ["header"],
52
+ ...options.resourceName ? { resource_name: options.resourceName } : {},
53
+ ...options.resourceDocumentation ? { resource_documentation: new URL(options.resourceDocumentation).toString() } : {}
54
+ };
55
+ }
56
+ function json(status, body, headers = {}) {
57
+ return new Response(JSON.stringify(body), {
58
+ status,
59
+ headers: {
60
+ "content-type": "application/json; charset=utf-8",
61
+ "cache-control": "no-store",
62
+ ...Object.fromEntries(new Headers(headers))
63
+ }
64
+ });
65
+ }
66
+ function bearerChallenge(metadataUrl, details = {}) {
67
+ const fields = [`resource_metadata="${metadataUrl.toString()}"`];
68
+ if (details.error) fields.push(`error="${details.error}"`);
69
+ if (details.description) {
70
+ fields.push(`error_description="${details.description.replace(/["\\]/g, "")}"`);
71
+ }
72
+ if (details.scope) fields.push(`scope="${details.scope.replace(/["\\]/g, "")}"`);
73
+ return `Bearer ${fields.join(", ")}`;
74
+ }
75
+ function authError(status, metadataUrl, details) {
76
+ return json(
77
+ status,
78
+ { error: details.error, error_description: details.description },
79
+ { "www-authenticate": bearerChallenge(metadataUrl, details) }
80
+ );
81
+ }
82
+ function bearerToken(request) {
83
+ const authorization = request.headers.get("authorization");
84
+ if (!authorization) return void 0;
85
+ const match = /^Bearer\s+([^\s]+)$/i.exec(authorization.trim());
86
+ return match?.[1];
87
+ }
88
+ function createOAuthResourceServerHandler(mcpHandler, options) {
89
+ const resource = normalizeResource(options.resource);
90
+ const metadata = createProtectedResourceMetadata(options);
91
+ const metadataUrl = protectedResourceMetadataUrl(resource);
92
+ return async (request) => {
93
+ const requestUrl = new URL(request.url);
94
+ if (request.method === "GET" && requestUrl.origin === metadataUrl.origin && requestUrl.pathname === metadataUrl.pathname) {
95
+ return json(200, metadata, { "cache-control": "public, max-age=300" });
96
+ }
97
+ const token = bearerToken(request);
98
+ if (!token) {
99
+ return authError(401, metadataUrl, {
100
+ error: "invalid_token",
101
+ description: "A Bearer access token is required"
102
+ });
103
+ }
104
+ let authInfo;
105
+ try {
106
+ authInfo = await options.verifier.verifyAccessToken(token);
107
+ } catch {
108
+ return authError(401, metadataUrl, {
109
+ error: "invalid_token",
110
+ description: "The access token is invalid"
111
+ });
112
+ }
113
+ const now = Math.floor((options.clock?.() ?? Date.now()) / 1e3);
114
+ if (authInfo.expiresAt !== void 0 && authInfo.expiresAt <= now) {
115
+ return authError(401, metadataUrl, {
116
+ error: "invalid_token",
117
+ description: "The access token has expired"
118
+ });
119
+ }
120
+ if (!authInfo.resource || normalizeResource(authInfo.resource).toString() !== resource.toString()) {
121
+ return authError(401, metadataUrl, {
122
+ error: "invalid_token",
123
+ description: "The access token is not bound to this resource"
124
+ });
125
+ }
126
+ let requiredScopes;
127
+ if (typeof options.requiredScopes === "function") {
128
+ const scopeRequest = request.clone();
129
+ try {
130
+ requiredScopes = await options.requiredScopes(scopeRequest);
131
+ } finally {
132
+ void scopeRequest.body?.cancel().catch(() => void 0);
133
+ }
134
+ } else {
135
+ requiredScopes = options.requiredScopes ?? [];
136
+ }
137
+ const grantedScopes = new Set(authInfo.scopes);
138
+ const missingScopes = requiredScopes.filter((scope) => !grantedScopes.has(scope));
139
+ if (missingScopes.length) {
140
+ return authError(403, metadataUrl, {
141
+ error: "insufficient_scope",
142
+ description: "The access token lacks required scopes",
143
+ scope: [...new Set(requiredScopes)].sort().join(" ")
144
+ });
145
+ }
146
+ return mcpHandler(request, { authInfo });
147
+ };
148
+ }
149
+
150
+ exports.MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID = MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID;
151
+ exports.MCP_ID_JAG_GRANT_PROFILE = MCP_ID_JAG_GRANT_PROFILE;
152
+ exports.createOAuthResourceServerHandler = createOAuthResourceServerHandler;
153
+ exports.createProtectedResourceMetadata = createProtectedResourceMetadata;
154
+ exports.enterpriseManagedAuthorizationClientMetadata = enterpriseManagedAuthorizationClientMetadata;
155
+ exports.protectedResourceMetadataUrl = protectedResourceMetadataUrl;
156
+ exports.withEnterpriseManagedAuthorization = withEnterpriseManagedAuthorization;
157
+ //# sourceMappingURL=index.cjs.map
158
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/enterprise.ts","../src/resource-server.ts"],"names":[],"mappings":";;;AAAO,IAAM,iDAAA,GACX;AAEK,IAAM,wBAAA,GACX;AAOK,SAAS,mCACd,QAAA,EAC0D;AAC1D,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,sCAAA,EAAwC;AAAA,MACtC,uBAAO,GAAA,CAAI;AAAA,QACT,GAAI,QAAA,CAAS,sCAAA,IAA0C,EAAC;AAAA,QACxD;AAAA,OACD;AAAA;AACH,GACF;AACF;AAGO,SAAS,4CAAA,GAAwE;AACtF,EAAA,OAAO;AAAA,IACL,4CAAA,EAA8C;AAAA,MAC5C,UAAA,EAAY;AAAA,QACV,CAAC,iDAAiD,GAAG;AAAC;AACxD;AACF,GACF;AACF;;;ACAA,SAAS,kBAAkB,QAAA,EAA6B;AACtD,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,QAAA,CAAS,UAAU,CAAA;AACvC,EAAA,GAAA,CAAI,IAAA,GAAO,EAAA;AACX,EAAA,OAAO,GAAA;AACT;AAEA,SAAS,OAAO,MAAA,EAAuC;AACrD,EAAA,OAAO,CAAC,GAAG,IAAI,IAAI,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,KAAU,IAAI,IAAI,KAAA,CAAM,QAAA,EAAU,CAAA,CAAE,QAAA,EAAU,CAAC,CAAC,EAAE,IAAA,EAAK;AACxF;AAEO,SAAS,6BAA6B,QAAA,EAA6B;AACxE,EAAA,MAAM,UAAA,GAAa,kBAAkB,QAAQ,CAAA;AAC7C,EAAA,MAAM,IAAA,GAAO,UAAA,CAAW,QAAA,KAAa,GAAA,GAAM,KAAK,UAAA,CAAW,QAAA;AAC3D,EAAA,OAAO,IAAI,GAAA,CAAI,CAAA,qCAAA,EAAwC,IAAI,CAAA,CAAA,EAAI,WAAW,MAAM,CAAA;AAClF;AAEO,SAAS,gCACd,OAAA,EACgC;AAChC,EAAA,MAAM,QAAA,GAAW,iBAAA,CAAkB,OAAA,CAAQ,QAAQ,CAAA;AACnD,EAAA,IAAI,CAAC,OAAA,CAAQ,oBAAA,CAAqB,MAAA,EAAQ;AACxC,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,OAAO;AAAA,IACL,GAAG,OAAA,CAAQ,aAAA;AAAA,IACX,QAAA,EAAU,SAAS,QAAA,EAAS;AAAA,IAC5B,qBAAA,EAAuB,MAAA,CAAO,OAAA,CAAQ,oBAAoB,CAAA;AAAA,IAC1D,GAAI,OAAA,CAAQ,eAAA,GACR,EAAE,gBAAA,EAAkB,CAAC,GAAG,IAAI,GAAA,CAAI,OAAA,CAAQ,eAAe,CAAC,CAAA,CAAE,IAAA,EAAK,KAC/D,EAAC;AAAA,IACL,wBAAA,EAA0B,CAAC,QAAQ,CAAA;AAAA,IACnC,GAAI,QAAQ,YAAA,GAAe,EAAE,eAAe,OAAA,CAAQ,YAAA,KAAiB,EAAC;AAAA,IACtE,GAAI,OAAA,CAAQ,qBAAA,GACR,EAAE,sBAAA,EAAwB,IAAI,GAAA,CAAI,OAAA,CAAQ,qBAAqB,CAAA,CAAE,QAAA,EAAS,KAC1E;AAAC,GACP;AACF;AAEA,SAAS,IAAA,CAAK,MAAA,EAAgB,IAAA,EAAe,OAAA,GAAuB,EAAC,EAAa;AAChF,EAAA,OAAO,IAAI,QAAA,CAAS,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA,EAAG;AAAA,IACxC,MAAA;AAAA,IACA,OAAA,EAAS;AAAA,MACP,cAAA,EAAgB,iCAAA;AAAA,MAChB,eAAA,EAAiB,UAAA;AAAA,MACjB,GAAG,MAAA,CAAO,WAAA,CAAY,IAAI,OAAA,CAAQ,OAAO,CAAC;AAAA;AAC5C,GACD,CAAA;AACH;AAEA,SAAS,eAAA,CACP,WAAA,EACA,OAAA,GAAoE,EAAC,EAC7D;AACR,EAAA,MAAM,SAAS,CAAC,CAAA,mBAAA,EAAsB,WAAA,CAAY,QAAA,EAAU,CAAA,CAAA,CAAG,CAAA;AAC/D,EAAA,IAAI,QAAQ,KAAA,EAAO,MAAA,CAAO,KAAK,CAAA,OAAA,EAAU,OAAA,CAAQ,KAAK,CAAA,CAAA,CAAG,CAAA;AACzD,EAAA,IAAI,QAAQ,WAAA,EAAa;AACvB,IAAA,MAAA,CAAO,IAAA,CAAK,sBAAsB,OAAA,CAAQ,WAAA,CAAY,QAAQ,QAAA,EAAU,EAAE,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,EAChF;AACA,EAAA,IAAI,OAAA,CAAQ,KAAA,EAAO,MAAA,CAAO,IAAA,CAAK,CAAA,OAAA,EAAU,OAAA,CAAQ,KAAA,CAAM,OAAA,CAAQ,QAAA,EAAU,EAAE,CAAC,CAAA,CAAA,CAAG,CAAA;AAC/E,EAAA,OAAO,CAAA,OAAA,EAAU,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AACpC;AAEA,SAAS,SAAA,CACP,MAAA,EACA,WAAA,EACA,OAAA,EACU;AACV,EAAA,OAAO,IAAA;AAAA,IACL,MAAA;AAAA,IACA,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAO,iBAAA,EAAmB,QAAQ,WAAA,EAAY;AAAA,IAC/D,EAAE,kBAAA,EAAoB,eAAA,CAAgB,WAAA,EAAa,OAAO,CAAA;AAAE,GAC9D;AACF;AAEA,SAAS,YAAY,OAAA,EAAsC;AACzD,EAAA,MAAM,aAAA,GAAgB,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,eAAe,CAAA;AACzD,EAAA,IAAI,CAAC,eAAe,OAAO,MAAA;AAC3B,EAAA,MAAM,KAAA,GAAQ,sBAAA,CAAuB,IAAA,CAAK,aAAA,CAAc,MAAM,CAAA;AAC9D,EAAA,OAAO,QAAQ,CAAC,CAAA;AAClB;AAEO,SAAS,gCAAA,CACd,YACA,OAAA,EACyC;AACzC,EAAA,MAAM,QAAA,GAAW,iBAAA,CAAkB,OAAA,CAAQ,QAAQ,CAAA;AACnD,EAAA,MAAM,QAAA,GAAW,gCAAgC,OAAO,CAAA;AACxD,EAAA,MAAM,WAAA,GAAc,6BAA6B,QAAQ,CAAA;AACzD,EAAA,OAAO,OAAO,OAAA,KAAwC;AACpD,IAAA,MAAM,UAAA,GAAa,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AACtC,IAAA,IACE,OAAA,CAAQ,MAAA,KAAW,KAAA,IACnB,UAAA,CAAW,MAAA,KAAW,YAAY,MAAA,IAClC,UAAA,CAAW,QAAA,KAAa,WAAA,CAAY,QAAA,EACpC;AACA,MAAA,OAAO,KAAK,GAAA,EAAK,QAAA,EAAU,EAAE,eAAA,EAAiB,uBAAuB,CAAA;AAAA,IACvE;AAEA,IAAA,MAAM,KAAA,GAAQ,YAAY,OAAO,CAAA;AACjC,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,OAAO,SAAA,CAAU,KAAK,WAAA,EAAa;AAAA,QACjC,KAAA,EAAO,eAAA;AAAA,QACP,WAAA,EAAa;AAAA,OACd,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI;AACF,MAAA,QAAA,GAAW,MAAM,OAAA,CAAQ,QAAA,CAAS,iBAAA,CAAkB,KAAK,CAAA;AAAA,IAC3D,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,SAAA,CAAU,KAAK,WAAA,EAAa;AAAA,QACjC,KAAA,EAAO,eAAA;AAAA,QACP,WAAA,EAAa;AAAA,OACd,CAAA;AAAA,IACH;AACA,IAAA,MAAM,GAAA,GAAM,KAAK,KAAA,CAAA,CAAO,OAAA,CAAQ,SAAQ,IAAK,IAAA,CAAK,GAAA,EAAI,IAAK,GAAK,CAAA;AAChE,IAAA,IAAI,QAAA,CAAS,SAAA,KAAc,MAAA,IAAa,QAAA,CAAS,aAAa,GAAA,EAAK;AACjE,MAAA,OAAO,SAAA,CAAU,KAAK,WAAA,EAAa;AAAA,QACjC,KAAA,EAAO,eAAA;AAAA,QACP,WAAA,EAAa;AAAA,OACd,CAAA;AAAA,IACH;AACA,IAAA,IACE,CAAC,QAAA,CAAS,QAAA,IACV,iBAAA,CAAkB,QAAA,CAAS,QAAQ,CAAA,CAAE,QAAA,EAAS,KAAM,QAAA,CAAS,QAAA,EAAS,EACtE;AACA,MAAA,OAAO,SAAA,CAAU,KAAK,WAAA,EAAa;AAAA,QACjC,KAAA,EAAO,eAAA;AAAA,QACP,WAAA,EAAa;AAAA,OACd,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,cAAA;AACJ,IAAA,IAAI,OAAO,OAAA,CAAQ,cAAA,KAAmB,UAAA,EAAY;AAChD,MAAA,MAAM,YAAA,GAAe,QAAQ,KAAA,EAAM;AACnC,MAAA,IAAI;AACF,QAAA,cAAA,GAAiB,MAAM,OAAA,CAAQ,cAAA,CAAe,YAAY,CAAA;AAAA,MAC5D,CAAA,SAAE;AACA,QAAA,KAAK,aAAa,IAAA,EAAM,MAAA,EAAO,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AAAA,MACxD;AAAA,IACF,CAAA,MAAO;AACL,MAAA,cAAA,GAAiB,OAAA,CAAQ,kBAAkB,EAAC;AAAA,IAC9C;AACA,IAAA,MAAM,aAAA,GAAgB,IAAI,GAAA,CAAI,QAAA,CAAS,MAAM,CAAA;AAC7C,IAAA,MAAM,aAAA,GAAgB,eAAe,MAAA,CAAO,CAAC,UAAU,CAAC,aAAA,CAAc,GAAA,CAAI,KAAK,CAAC,CAAA;AAChF,IAAA,IAAI,cAAc,MAAA,EAAQ;AACxB,MAAA,OAAO,SAAA,CAAU,KAAK,WAAA,EAAa;AAAA,QACjC,KAAA,EAAO,oBAAA;AAAA,QACP,WAAA,EAAa,wCAAA;AAAA,QACb,KAAA,EAAO,CAAC,GAAG,IAAI,GAAA,CAAI,cAAc,CAAC,CAAA,CAAE,IAAA,EAAK,CAAE,IAAA,CAAK,GAAG;AAAA,OACpD,CAAA;AAAA,IACH;AACA,IAAA,OAAO,UAAA,CAAW,OAAA,EAAS,EAAE,QAAA,EAAU,CAAA;AAAA,EACzC,CAAA;AACF","file":"index.cjs","sourcesContent":["export const MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID =\n \"io.modelcontextprotocol/enterprise-managed-authorization\";\n\nexport const MCP_ID_JAG_GRANT_PROFILE =\n \"urn:ietf:params:oauth:grant-profile:id-jag\";\n\nexport interface McpFnAuthorizationServerMetadata extends Record<string, unknown> {\n authorization_grant_profiles_supported?: string[];\n}\n\n/** Adds the stable ID-JAG discovery marker to authorization-server metadata. */\nexport function withEnterpriseManagedAuthorization<T extends McpFnAuthorizationServerMetadata>(\n metadata: T,\n): T & { authorization_grant_profiles_supported: string[] } {\n return {\n ...metadata,\n authorization_grant_profiles_supported: [\n ...new Set([\n ...(metadata.authorization_grant_profiles_supported ?? []),\n MCP_ID_JAG_GRANT_PROFILE,\n ]),\n ],\n };\n}\n\n/** Metadata clients attach to requests when declaring extension support. */\nexport function enterpriseManagedAuthorizationClientMetadata(): Record<string, unknown> {\n return {\n \"io.modelcontextprotocol/clientCapabilities\": {\n extensions: {\n [MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID]: {},\n },\n },\n };\n}\n","import type { AuthInfo } from \"@modelcontextprotocol/sdk/server/auth/types.js\";\nimport type { OAuthTokenVerifier } from \"@modelcontextprotocol/sdk/server/auth/provider.js\";\nimport type { HandleRequestOptions } from \"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js\";\n\nexport interface McpFnProtectedResourceMetadata extends Record<string, unknown> {\n resource: string;\n authorization_servers: string[];\n scopes_supported?: string[];\n bearer_methods_supported?: string[];\n resource_name?: string;\n resource_documentation?: string;\n}\n\nexport interface McpFnProtectedResourceOptions {\n resource: string | URL;\n authorizationServers: Array<string | URL>;\n scopesSupported?: string[];\n resourceName?: string;\n resourceDocumentation?: string;\n extraMetadata?: Record<string, unknown>;\n}\n\nexport interface McpFnOAuthResourceServerOptions\n extends McpFnProtectedResourceOptions {\n verifier: OAuthTokenVerifier;\n requiredScopes?: string[] | ((request: Request) => string[] | Promise<string[]>);\n clock?: () => number;\n}\n\nexport type McpFnWebStandardHandler = (\n request: Request,\n options?: HandleRequestOptions,\n) => Promise<Response>;\n\nfunction normalizeResource(resource: string | URL): URL {\n const url = new URL(resource.toString());\n url.hash = \"\";\n return url;\n}\n\nfunction unique(values: Array<string | URL>): string[] {\n return [...new Set(values.map((value) => new URL(value.toString()).toString()))].sort();\n}\n\nexport function protectedResourceMetadataUrl(resource: string | URL): URL {\n const normalized = normalizeResource(resource);\n const path = normalized.pathname === \"/\" ? \"\" : normalized.pathname;\n return new URL(`/.well-known/oauth-protected-resource${path}`, normalized.origin);\n}\n\nexport function createProtectedResourceMetadata(\n options: McpFnProtectedResourceOptions,\n): McpFnProtectedResourceMetadata {\n const resource = normalizeResource(options.resource);\n if (!options.authorizationServers.length) {\n throw new Error(\"At least one OAuth authorization server is required\");\n }\n return {\n ...options.extraMetadata,\n resource: resource.toString(),\n authorization_servers: unique(options.authorizationServers),\n ...(options.scopesSupported\n ? { scopes_supported: [...new Set(options.scopesSupported)].sort() }\n : {}),\n bearer_methods_supported: [\"header\"],\n ...(options.resourceName ? { resource_name: options.resourceName } : {}),\n ...(options.resourceDocumentation\n ? { resource_documentation: new URL(options.resourceDocumentation).toString() }\n : {}),\n };\n}\n\nfunction json(status: number, body: unknown, headers: HeadersInit = {}): Response {\n return new Response(JSON.stringify(body), {\n status,\n headers: {\n \"content-type\": \"application/json; charset=utf-8\",\n \"cache-control\": \"no-store\",\n ...Object.fromEntries(new Headers(headers)),\n },\n });\n}\n\nfunction bearerChallenge(\n metadataUrl: URL,\n details: { error?: string; description?: string; scope?: string } = {},\n): string {\n const fields = [`resource_metadata=\"${metadataUrl.toString()}\"`];\n if (details.error) fields.push(`error=\"${details.error}\"`);\n if (details.description) {\n fields.push(`error_description=\"${details.description.replace(/[\"\\\\]/g, \"\")}\"`);\n }\n if (details.scope) fields.push(`scope=\"${details.scope.replace(/[\"\\\\]/g, \"\")}\"`);\n return `Bearer ${fields.join(\", \")}`;\n}\n\nfunction authError(\n status: 401 | 403,\n metadataUrl: URL,\n details: { error: string; description: string; scope?: string },\n): Response {\n return json(\n status,\n { error: details.error, error_description: details.description },\n { \"www-authenticate\": bearerChallenge(metadataUrl, details) },\n );\n}\n\nfunction bearerToken(request: Request): string | undefined {\n const authorization = request.headers.get(\"authorization\");\n if (!authorization) return undefined;\n const match = /^Bearer\\s+([^\\s]+)$/i.exec(authorization.trim());\n return match?.[1];\n}\n\nexport function createOAuthResourceServerHandler(\n mcpHandler: McpFnWebStandardHandler,\n options: McpFnOAuthResourceServerOptions,\n): (request: Request) => Promise<Response> {\n const resource = normalizeResource(options.resource);\n const metadata = createProtectedResourceMetadata(options);\n const metadataUrl = protectedResourceMetadataUrl(resource);\n return async (request: Request): Promise<Response> => {\n const requestUrl = new URL(request.url);\n if (\n request.method === \"GET\" &&\n requestUrl.origin === metadataUrl.origin &&\n requestUrl.pathname === metadataUrl.pathname\n ) {\n return json(200, metadata, { \"cache-control\": \"public, max-age=300\" });\n }\n\n const token = bearerToken(request);\n if (!token) {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"A Bearer access token is required\",\n });\n }\n\n let authInfo: AuthInfo;\n try {\n authInfo = await options.verifier.verifyAccessToken(token);\n } catch {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"The access token is invalid\",\n });\n }\n const now = Math.floor((options.clock?.() ?? Date.now()) / 1_000);\n if (authInfo.expiresAt !== undefined && authInfo.expiresAt <= now) {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"The access token has expired\",\n });\n }\n if (\n !authInfo.resource ||\n normalizeResource(authInfo.resource).toString() !== resource.toString()\n ) {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"The access token is not bound to this resource\",\n });\n }\n\n let requiredScopes: string[];\n if (typeof options.requiredScopes === \"function\") {\n const scopeRequest = request.clone();\n try {\n requiredScopes = await options.requiredScopes(scopeRequest);\n } finally {\n void scopeRequest.body?.cancel().catch(() => undefined);\n }\n } else {\n requiredScopes = options.requiredScopes ?? [];\n }\n const grantedScopes = new Set(authInfo.scopes);\n const missingScopes = requiredScopes.filter((scope) => !grantedScopes.has(scope));\n if (missingScopes.length) {\n return authError(403, metadataUrl, {\n error: \"insufficient_scope\",\n description: \"The access token lacks required scopes\",\n scope: [...new Set(requiredScopes)].sort().join(\" \"),\n });\n }\n return mcpHandler(request, { authInfo });\n };\n}\n"]}
@@ -0,0 +1,42 @@
1
+ import { OAuthTokenVerifier } from '@modelcontextprotocol/sdk/server/auth/provider.js';
2
+ import { HandleRequestOptions } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
3
+
4
+ declare const MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID = "io.modelcontextprotocol/enterprise-managed-authorization";
5
+ declare const MCP_ID_JAG_GRANT_PROFILE = "urn:ietf:params:oauth:grant-profile:id-jag";
6
+ interface McpFnAuthorizationServerMetadata extends Record<string, unknown> {
7
+ authorization_grant_profiles_supported?: string[];
8
+ }
9
+ /** Adds the stable ID-JAG discovery marker to authorization-server metadata. */
10
+ declare function withEnterpriseManagedAuthorization<T extends McpFnAuthorizationServerMetadata>(metadata: T): T & {
11
+ authorization_grant_profiles_supported: string[];
12
+ };
13
+ /** Metadata clients attach to requests when declaring extension support. */
14
+ declare function enterpriseManagedAuthorizationClientMetadata(): Record<string, unknown>;
15
+
16
+ interface McpFnProtectedResourceMetadata extends Record<string, unknown> {
17
+ resource: string;
18
+ authorization_servers: string[];
19
+ scopes_supported?: string[];
20
+ bearer_methods_supported?: string[];
21
+ resource_name?: string;
22
+ resource_documentation?: string;
23
+ }
24
+ interface McpFnProtectedResourceOptions {
25
+ resource: string | URL;
26
+ authorizationServers: Array<string | URL>;
27
+ scopesSupported?: string[];
28
+ resourceName?: string;
29
+ resourceDocumentation?: string;
30
+ extraMetadata?: Record<string, unknown>;
31
+ }
32
+ interface McpFnOAuthResourceServerOptions extends McpFnProtectedResourceOptions {
33
+ verifier: OAuthTokenVerifier;
34
+ requiredScopes?: string[] | ((request: Request) => string[] | Promise<string[]>);
35
+ clock?: () => number;
36
+ }
37
+ type McpFnWebStandardHandler = (request: Request, options?: HandleRequestOptions) => Promise<Response>;
38
+ declare function protectedResourceMetadataUrl(resource: string | URL): URL;
39
+ declare function createProtectedResourceMetadata(options: McpFnProtectedResourceOptions): McpFnProtectedResourceMetadata;
40
+ declare function createOAuthResourceServerHandler(mcpHandler: McpFnWebStandardHandler, options: McpFnOAuthResourceServerOptions): (request: Request) => Promise<Response>;
41
+
42
+ export { MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID, MCP_ID_JAG_GRANT_PROFILE, type McpFnAuthorizationServerMetadata, type McpFnOAuthResourceServerOptions, type McpFnProtectedResourceMetadata, type McpFnProtectedResourceOptions, type McpFnWebStandardHandler, createOAuthResourceServerHandler, createProtectedResourceMetadata, enterpriseManagedAuthorizationClientMetadata, protectedResourceMetadataUrl, withEnterpriseManagedAuthorization };
@@ -0,0 +1,42 @@
1
+ import { OAuthTokenVerifier } from '@modelcontextprotocol/sdk/server/auth/provider.js';
2
+ import { HandleRequestOptions } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
3
+
4
+ declare const MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID = "io.modelcontextprotocol/enterprise-managed-authorization";
5
+ declare const MCP_ID_JAG_GRANT_PROFILE = "urn:ietf:params:oauth:grant-profile:id-jag";
6
+ interface McpFnAuthorizationServerMetadata extends Record<string, unknown> {
7
+ authorization_grant_profiles_supported?: string[];
8
+ }
9
+ /** Adds the stable ID-JAG discovery marker to authorization-server metadata. */
10
+ declare function withEnterpriseManagedAuthorization<T extends McpFnAuthorizationServerMetadata>(metadata: T): T & {
11
+ authorization_grant_profiles_supported: string[];
12
+ };
13
+ /** Metadata clients attach to requests when declaring extension support. */
14
+ declare function enterpriseManagedAuthorizationClientMetadata(): Record<string, unknown>;
15
+
16
+ interface McpFnProtectedResourceMetadata extends Record<string, unknown> {
17
+ resource: string;
18
+ authorization_servers: string[];
19
+ scopes_supported?: string[];
20
+ bearer_methods_supported?: string[];
21
+ resource_name?: string;
22
+ resource_documentation?: string;
23
+ }
24
+ interface McpFnProtectedResourceOptions {
25
+ resource: string | URL;
26
+ authorizationServers: Array<string | URL>;
27
+ scopesSupported?: string[];
28
+ resourceName?: string;
29
+ resourceDocumentation?: string;
30
+ extraMetadata?: Record<string, unknown>;
31
+ }
32
+ interface McpFnOAuthResourceServerOptions extends McpFnProtectedResourceOptions {
33
+ verifier: OAuthTokenVerifier;
34
+ requiredScopes?: string[] | ((request: Request) => string[] | Promise<string[]>);
35
+ clock?: () => number;
36
+ }
37
+ type McpFnWebStandardHandler = (request: Request, options?: HandleRequestOptions) => Promise<Response>;
38
+ declare function protectedResourceMetadataUrl(resource: string | URL): URL;
39
+ declare function createProtectedResourceMetadata(options: McpFnProtectedResourceOptions): McpFnProtectedResourceMetadata;
40
+ declare function createOAuthResourceServerHandler(mcpHandler: McpFnWebStandardHandler, options: McpFnOAuthResourceServerOptions): (request: Request) => Promise<Response>;
41
+
42
+ export { MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID, MCP_ID_JAG_GRANT_PROFILE, type McpFnAuthorizationServerMetadata, type McpFnOAuthResourceServerOptions, type McpFnProtectedResourceMetadata, type McpFnProtectedResourceOptions, type McpFnWebStandardHandler, createOAuthResourceServerHandler, createProtectedResourceMetadata, enterpriseManagedAuthorizationClientMetadata, protectedResourceMetadataUrl, withEnterpriseManagedAuthorization };
package/dist/index.js ADDED
@@ -0,0 +1,150 @@
1
+ // src/enterprise.ts
2
+ var MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID = "io.modelcontextprotocol/enterprise-managed-authorization";
3
+ var MCP_ID_JAG_GRANT_PROFILE = "urn:ietf:params:oauth:grant-profile:id-jag";
4
+ function withEnterpriseManagedAuthorization(metadata) {
5
+ return {
6
+ ...metadata,
7
+ authorization_grant_profiles_supported: [
8
+ .../* @__PURE__ */ new Set([
9
+ ...metadata.authorization_grant_profiles_supported ?? [],
10
+ MCP_ID_JAG_GRANT_PROFILE
11
+ ])
12
+ ]
13
+ };
14
+ }
15
+ function enterpriseManagedAuthorizationClientMetadata() {
16
+ return {
17
+ "io.modelcontextprotocol/clientCapabilities": {
18
+ extensions: {
19
+ [MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID]: {}
20
+ }
21
+ }
22
+ };
23
+ }
24
+
25
+ // src/resource-server.ts
26
+ function normalizeResource(resource) {
27
+ const url = new URL(resource.toString());
28
+ url.hash = "";
29
+ return url;
30
+ }
31
+ function unique(values) {
32
+ return [...new Set(values.map((value) => new URL(value.toString()).toString()))].sort();
33
+ }
34
+ function protectedResourceMetadataUrl(resource) {
35
+ const normalized = normalizeResource(resource);
36
+ const path = normalized.pathname === "/" ? "" : normalized.pathname;
37
+ return new URL(`/.well-known/oauth-protected-resource${path}`, normalized.origin);
38
+ }
39
+ function createProtectedResourceMetadata(options) {
40
+ const resource = normalizeResource(options.resource);
41
+ if (!options.authorizationServers.length) {
42
+ throw new Error("At least one OAuth authorization server is required");
43
+ }
44
+ return {
45
+ ...options.extraMetadata,
46
+ resource: resource.toString(),
47
+ authorization_servers: unique(options.authorizationServers),
48
+ ...options.scopesSupported ? { scopes_supported: [...new Set(options.scopesSupported)].sort() } : {},
49
+ bearer_methods_supported: ["header"],
50
+ ...options.resourceName ? { resource_name: options.resourceName } : {},
51
+ ...options.resourceDocumentation ? { resource_documentation: new URL(options.resourceDocumentation).toString() } : {}
52
+ };
53
+ }
54
+ function json(status, body, headers = {}) {
55
+ return new Response(JSON.stringify(body), {
56
+ status,
57
+ headers: {
58
+ "content-type": "application/json; charset=utf-8",
59
+ "cache-control": "no-store",
60
+ ...Object.fromEntries(new Headers(headers))
61
+ }
62
+ });
63
+ }
64
+ function bearerChallenge(metadataUrl, details = {}) {
65
+ const fields = [`resource_metadata="${metadataUrl.toString()}"`];
66
+ if (details.error) fields.push(`error="${details.error}"`);
67
+ if (details.description) {
68
+ fields.push(`error_description="${details.description.replace(/["\\]/g, "")}"`);
69
+ }
70
+ if (details.scope) fields.push(`scope="${details.scope.replace(/["\\]/g, "")}"`);
71
+ return `Bearer ${fields.join(", ")}`;
72
+ }
73
+ function authError(status, metadataUrl, details) {
74
+ return json(
75
+ status,
76
+ { error: details.error, error_description: details.description },
77
+ { "www-authenticate": bearerChallenge(metadataUrl, details) }
78
+ );
79
+ }
80
+ function bearerToken(request) {
81
+ const authorization = request.headers.get("authorization");
82
+ if (!authorization) return void 0;
83
+ const match = /^Bearer\s+([^\s]+)$/i.exec(authorization.trim());
84
+ return match?.[1];
85
+ }
86
+ function createOAuthResourceServerHandler(mcpHandler, options) {
87
+ const resource = normalizeResource(options.resource);
88
+ const metadata = createProtectedResourceMetadata(options);
89
+ const metadataUrl = protectedResourceMetadataUrl(resource);
90
+ return async (request) => {
91
+ const requestUrl = new URL(request.url);
92
+ if (request.method === "GET" && requestUrl.origin === metadataUrl.origin && requestUrl.pathname === metadataUrl.pathname) {
93
+ return json(200, metadata, { "cache-control": "public, max-age=300" });
94
+ }
95
+ const token = bearerToken(request);
96
+ if (!token) {
97
+ return authError(401, metadataUrl, {
98
+ error: "invalid_token",
99
+ description: "A Bearer access token is required"
100
+ });
101
+ }
102
+ let authInfo;
103
+ try {
104
+ authInfo = await options.verifier.verifyAccessToken(token);
105
+ } catch {
106
+ return authError(401, metadataUrl, {
107
+ error: "invalid_token",
108
+ description: "The access token is invalid"
109
+ });
110
+ }
111
+ const now = Math.floor((options.clock?.() ?? Date.now()) / 1e3);
112
+ if (authInfo.expiresAt !== void 0 && authInfo.expiresAt <= now) {
113
+ return authError(401, metadataUrl, {
114
+ error: "invalid_token",
115
+ description: "The access token has expired"
116
+ });
117
+ }
118
+ if (!authInfo.resource || normalizeResource(authInfo.resource).toString() !== resource.toString()) {
119
+ return authError(401, metadataUrl, {
120
+ error: "invalid_token",
121
+ description: "The access token is not bound to this resource"
122
+ });
123
+ }
124
+ let requiredScopes;
125
+ if (typeof options.requiredScopes === "function") {
126
+ const scopeRequest = request.clone();
127
+ try {
128
+ requiredScopes = await options.requiredScopes(scopeRequest);
129
+ } finally {
130
+ void scopeRequest.body?.cancel().catch(() => void 0);
131
+ }
132
+ } else {
133
+ requiredScopes = options.requiredScopes ?? [];
134
+ }
135
+ const grantedScopes = new Set(authInfo.scopes);
136
+ const missingScopes = requiredScopes.filter((scope) => !grantedScopes.has(scope));
137
+ if (missingScopes.length) {
138
+ return authError(403, metadataUrl, {
139
+ error: "insufficient_scope",
140
+ description: "The access token lacks required scopes",
141
+ scope: [...new Set(requiredScopes)].sort().join(" ")
142
+ });
143
+ }
144
+ return mcpHandler(request, { authInfo });
145
+ };
146
+ }
147
+
148
+ export { MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID, MCP_ID_JAG_GRANT_PROFILE, createOAuthResourceServerHandler, createProtectedResourceMetadata, enterpriseManagedAuthorizationClientMetadata, protectedResourceMetadataUrl, withEnterpriseManagedAuthorization };
149
+ //# sourceMappingURL=index.js.map
150
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/enterprise.ts","../src/resource-server.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID =\n \"io.modelcontextprotocol/enterprise-managed-authorization\";\n\nexport const MCP_ID_JAG_GRANT_PROFILE =\n \"urn:ietf:params:oauth:grant-profile:id-jag\";\n\nexport interface McpFnAuthorizationServerMetadata extends Record<string, unknown> {\n authorization_grant_profiles_supported?: string[];\n}\n\n/** Adds the stable ID-JAG discovery marker to authorization-server metadata. */\nexport function withEnterpriseManagedAuthorization<T extends McpFnAuthorizationServerMetadata>(\n metadata: T,\n): T & { authorization_grant_profiles_supported: string[] } {\n return {\n ...metadata,\n authorization_grant_profiles_supported: [\n ...new Set([\n ...(metadata.authorization_grant_profiles_supported ?? []),\n MCP_ID_JAG_GRANT_PROFILE,\n ]),\n ],\n };\n}\n\n/** Metadata clients attach to requests when declaring extension support. */\nexport function enterpriseManagedAuthorizationClientMetadata(): Record<string, unknown> {\n return {\n \"io.modelcontextprotocol/clientCapabilities\": {\n extensions: {\n [MCP_ENTERPRISE_MANAGED_AUTHORIZATION_EXTENSION_ID]: {},\n },\n },\n };\n}\n","import type { AuthInfo } from \"@modelcontextprotocol/sdk/server/auth/types.js\";\nimport type { OAuthTokenVerifier } from \"@modelcontextprotocol/sdk/server/auth/provider.js\";\nimport type { HandleRequestOptions } from \"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js\";\n\nexport interface McpFnProtectedResourceMetadata extends Record<string, unknown> {\n resource: string;\n authorization_servers: string[];\n scopes_supported?: string[];\n bearer_methods_supported?: string[];\n resource_name?: string;\n resource_documentation?: string;\n}\n\nexport interface McpFnProtectedResourceOptions {\n resource: string | URL;\n authorizationServers: Array<string | URL>;\n scopesSupported?: string[];\n resourceName?: string;\n resourceDocumentation?: string;\n extraMetadata?: Record<string, unknown>;\n}\n\nexport interface McpFnOAuthResourceServerOptions\n extends McpFnProtectedResourceOptions {\n verifier: OAuthTokenVerifier;\n requiredScopes?: string[] | ((request: Request) => string[] | Promise<string[]>);\n clock?: () => number;\n}\n\nexport type McpFnWebStandardHandler = (\n request: Request,\n options?: HandleRequestOptions,\n) => Promise<Response>;\n\nfunction normalizeResource(resource: string | URL): URL {\n const url = new URL(resource.toString());\n url.hash = \"\";\n return url;\n}\n\nfunction unique(values: Array<string | URL>): string[] {\n return [...new Set(values.map((value) => new URL(value.toString()).toString()))].sort();\n}\n\nexport function protectedResourceMetadataUrl(resource: string | URL): URL {\n const normalized = normalizeResource(resource);\n const path = normalized.pathname === \"/\" ? \"\" : normalized.pathname;\n return new URL(`/.well-known/oauth-protected-resource${path}`, normalized.origin);\n}\n\nexport function createProtectedResourceMetadata(\n options: McpFnProtectedResourceOptions,\n): McpFnProtectedResourceMetadata {\n const resource = normalizeResource(options.resource);\n if (!options.authorizationServers.length) {\n throw new Error(\"At least one OAuth authorization server is required\");\n }\n return {\n ...options.extraMetadata,\n resource: resource.toString(),\n authorization_servers: unique(options.authorizationServers),\n ...(options.scopesSupported\n ? { scopes_supported: [...new Set(options.scopesSupported)].sort() }\n : {}),\n bearer_methods_supported: [\"header\"],\n ...(options.resourceName ? { resource_name: options.resourceName } : {}),\n ...(options.resourceDocumentation\n ? { resource_documentation: new URL(options.resourceDocumentation).toString() }\n : {}),\n };\n}\n\nfunction json(status: number, body: unknown, headers: HeadersInit = {}): Response {\n return new Response(JSON.stringify(body), {\n status,\n headers: {\n \"content-type\": \"application/json; charset=utf-8\",\n \"cache-control\": \"no-store\",\n ...Object.fromEntries(new Headers(headers)),\n },\n });\n}\n\nfunction bearerChallenge(\n metadataUrl: URL,\n details: { error?: string; description?: string; scope?: string } = {},\n): string {\n const fields = [`resource_metadata=\"${metadataUrl.toString()}\"`];\n if (details.error) fields.push(`error=\"${details.error}\"`);\n if (details.description) {\n fields.push(`error_description=\"${details.description.replace(/[\"\\\\]/g, \"\")}\"`);\n }\n if (details.scope) fields.push(`scope=\"${details.scope.replace(/[\"\\\\]/g, \"\")}\"`);\n return `Bearer ${fields.join(\", \")}`;\n}\n\nfunction authError(\n status: 401 | 403,\n metadataUrl: URL,\n details: { error: string; description: string; scope?: string },\n): Response {\n return json(\n status,\n { error: details.error, error_description: details.description },\n { \"www-authenticate\": bearerChallenge(metadataUrl, details) },\n );\n}\n\nfunction bearerToken(request: Request): string | undefined {\n const authorization = request.headers.get(\"authorization\");\n if (!authorization) return undefined;\n const match = /^Bearer\\s+([^\\s]+)$/i.exec(authorization.trim());\n return match?.[1];\n}\n\nexport function createOAuthResourceServerHandler(\n mcpHandler: McpFnWebStandardHandler,\n options: McpFnOAuthResourceServerOptions,\n): (request: Request) => Promise<Response> {\n const resource = normalizeResource(options.resource);\n const metadata = createProtectedResourceMetadata(options);\n const metadataUrl = protectedResourceMetadataUrl(resource);\n return async (request: Request): Promise<Response> => {\n const requestUrl = new URL(request.url);\n if (\n request.method === \"GET\" &&\n requestUrl.origin === metadataUrl.origin &&\n requestUrl.pathname === metadataUrl.pathname\n ) {\n return json(200, metadata, { \"cache-control\": \"public, max-age=300\" });\n }\n\n const token = bearerToken(request);\n if (!token) {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"A Bearer access token is required\",\n });\n }\n\n let authInfo: AuthInfo;\n try {\n authInfo = await options.verifier.verifyAccessToken(token);\n } catch {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"The access token is invalid\",\n });\n }\n const now = Math.floor((options.clock?.() ?? Date.now()) / 1_000);\n if (authInfo.expiresAt !== undefined && authInfo.expiresAt <= now) {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"The access token has expired\",\n });\n }\n if (\n !authInfo.resource ||\n normalizeResource(authInfo.resource).toString() !== resource.toString()\n ) {\n return authError(401, metadataUrl, {\n error: \"invalid_token\",\n description: \"The access token is not bound to this resource\",\n });\n }\n\n let requiredScopes: string[];\n if (typeof options.requiredScopes === \"function\") {\n const scopeRequest = request.clone();\n try {\n requiredScopes = await options.requiredScopes(scopeRequest);\n } finally {\n void scopeRequest.body?.cancel().catch(() => undefined);\n }\n } else {\n requiredScopes = options.requiredScopes ?? [];\n }\n const grantedScopes = new Set(authInfo.scopes);\n const missingScopes = requiredScopes.filter((scope) => !grantedScopes.has(scope));\n if (missingScopes.length) {\n return authError(403, metadataUrl, {\n error: \"insufficient_scope\",\n description: \"The access token lacks required scopes\",\n scope: [...new Set(requiredScopes)].sort().join(\" \"),\n });\n }\n return mcpHandler(request, { authInfo });\n };\n}\n"]}
package/package.json ADDED
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "@mcpfn/auth",
3
+ "version": "0.0.1",
4
+ "description": "Web Standard OAuth protected-resource middleware and enterprise-managed authorization helpers for MCP",
5
+ "type": "module",
6
+ "main": "dist/index.cjs",
7
+ "module": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.js",
13
+ "require": "./dist/index.cjs"
14
+ }
15
+ },
16
+ "files": ["dist", "README.md"],
17
+ "scripts": {
18
+ "build": "tsup",
19
+ "clean": "node --input-type=module -e \"import('node:fs').then(({ rmSync }) => rmSync('dist', { recursive: true, force: true }))\"",
20
+ "lint": "tsc --noEmit",
21
+ "test": "vitest run",
22
+ "typecheck": "tsc --noEmit"
23
+ },
24
+ "dependencies": {
25
+ "@modelcontextprotocol/sdk": "1.25.2"
26
+ },
27
+ "devDependencies": {
28
+ "@types/node": "^20.0.0",
29
+ "tsup": "^8.5.0",
30
+ "typescript": "^5.9.3",
31
+ "vitest": "^3.2.4"
32
+ },
33
+ "engines": { "node": ">=18.18.0" },
34
+ "license": "MIT",
35
+ "repository": {
36
+ "type": "git",
37
+ "url": "git+https://github.com/21nCo/super-functions.git",
38
+ "directory": "mcpfn/auth"
39
+ },
40
+ "publishConfig": { "access": "public" },
41
+ "sideEffects": false
42
+ }