@payloadcms/plugin-mcp 4.0.0-internal.5b1e7cd → 4.0.0-internal.5d2e3d1
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/LICENSE.md +1 -1
- package/bin.js +39 -0
- package/dist/defaultAccess.d.ts +3 -0
- package/dist/defaultAccess.d.ts.map +1 -0
- package/dist/defaultAccess.js +3 -0
- package/dist/defaultAccess.js.map +1 -0
- package/dist/defineTool.d.ts +26 -0
- package/dist/defineTool.d.ts.map +1 -0
- package/dist/defineTool.js +37 -0
- package/dist/defineTool.js.map +1 -0
- package/dist/endpoint/access.d.ts +22 -0
- package/dist/endpoint/access.d.ts.map +1 -0
- package/dist/endpoint/access.js +130 -0
- package/dist/endpoint/access.js.map +1 -0
- package/dist/endpoint/index.d.ts +3 -0
- package/dist/endpoint/index.d.ts.map +1 -0
- package/dist/endpoint/index.js +141 -0
- package/dist/endpoint/index.js.map +1 -0
- package/dist/endpoint/oauth.d.ts +37 -0
- package/dist/endpoint/oauth.d.ts.map +1 -0
- package/dist/endpoint/oauth.js +105 -0
- package/dist/endpoint/oauth.js.map +1 -0
- package/dist/endpoint/oauthLoginToken.d.ts +23 -0
- package/dist/endpoint/oauthLoginToken.d.ts.map +1 -0
- package/dist/endpoint/oauthLoginToken.js +80 -0
- package/dist/endpoint/oauthLoginToken.js.map +1 -0
- package/dist/endpoint/oauthServer.d.ts +28 -0
- package/dist/endpoint/oauthServer.d.ts.map +1 -0
- package/dist/endpoint/oauthServer.js +423 -0
- package/dist/endpoint/oauthServer.js.map +1 -0
- package/dist/exports/client.d.ts +2 -0
- package/dist/exports/client.d.ts.map +1 -0
- package/dist/exports/client.js +4 -0
- package/dist/exports/client.js.map +1 -0
- package/dist/exports/internal.d.ts +2 -0
- package/dist/exports/internal.d.ts.map +1 -0
- package/dist/exports/internal.js +3 -0
- package/dist/exports/internal.js.map +1 -0
- package/dist/exports/rsc.d.ts +2 -0
- package/dist/exports/rsc.d.ts.map +1 -0
- package/dist/exports/rsc.js +3 -0
- package/dist/exports/rsc.js.map +1 -0
- package/dist/index.d.ts +14 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +63 -67
- package/dist/index.js.map +1 -1
- package/dist/mcp/buildMcpServer.d.ts +19 -0
- package/dist/mcp/buildMcpServer.d.ts.map +1 -0
- package/dist/mcp/buildMcpServer.js +235 -0
- package/dist/mcp/buildMcpServer.js.map +1 -0
- package/dist/mcp/builtin/collections/authTools.d.ts +7 -0
- package/dist/mcp/builtin/collections/authTools.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/authTools.js +312 -0
- package/dist/mcp/builtin/collections/authTools.js.map +1 -0
- package/dist/mcp/builtin/collections/countTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/countTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/countTool.js +63 -0
- package/dist/mcp/builtin/collections/countTool.js.map +1 -0
- package/dist/mcp/builtin/collections/countVersionsTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/countVersionsTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/countVersionsTool.js +60 -0
- package/dist/mcp/builtin/collections/countVersionsTool.js.map +1 -0
- package/dist/mcp/builtin/collections/createTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/createTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/createTool.js +137 -0
- package/dist/mcp/builtin/collections/createTool.js.map +1 -0
- package/dist/mcp/builtin/collections/deleteTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/deleteTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/deleteTool.js +113 -0
- package/dist/mcp/builtin/collections/deleteTool.js.map +1 -0
- package/dist/mcp/builtin/collections/duplicateTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/duplicateTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/duplicateTool.js +90 -0
- package/dist/mcp/builtin/collections/duplicateTool.js.map +1 -0
- package/dist/mcp/builtin/collections/fileInput.d.ts +28 -0
- package/dist/mcp/builtin/collections/fileInput.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/fileInput.js +88 -0
- package/dist/mcp/builtin/collections/fileInput.js.map +1 -0
- package/dist/mcp/builtin/collections/findDistinctTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/findDistinctTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/findDistinctTool.js +77 -0
- package/dist/mcp/builtin/collections/findDistinctTool.js.map +1 -0
- package/dist/mcp/builtin/collections/findTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/findTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/findTool.js +146 -0
- package/dist/mcp/builtin/collections/findTool.js.map +1 -0
- package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/findVersionByIDTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/findVersionByIDTool.js +74 -0
- package/dist/mcp/builtin/collections/findVersionByIDTool.js.map +1 -0
- package/dist/mcp/builtin/collections/findVersionsTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/findVersionsTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/findVersionsTool.js +84 -0
- package/dist/mcp/builtin/collections/findVersionsTool.js.map +1 -0
- package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/getCollectionSchemaTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/getCollectionSchemaTool.js +103 -0
- package/dist/mcp/builtin/collections/getCollectionSchemaTool.js.map +1 -0
- package/dist/mcp/builtin/collections/restoreVersionTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/restoreVersionTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/restoreVersionTool.js +69 -0
- package/dist/mcp/builtin/collections/restoreVersionTool.js.map +1 -0
- package/dist/mcp/builtin/collections/updateTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/updateTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/updateTool.js +172 -0
- package/dist/mcp/builtin/collections/updateTool.js.map +1 -0
- package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts +2 -0
- package/dist/mcp/builtin/collections/uploadInstructionsTool.d.ts.map +1 -0
- package/dist/mcp/builtin/collections/uploadInstructionsTool.js +55 -0
- package/dist/mcp/builtin/collections/uploadInstructionsTool.js.map +1 -0
- package/dist/mcp/builtin/formatEntityError.d.ts +16 -0
- package/dist/mcp/builtin/formatEntityError.d.ts.map +1 -0
- package/dist/mcp/builtin/formatEntityError.js +55 -0
- package/dist/mcp/builtin/formatEntityError.js.map +1 -0
- package/dist/mcp/builtin/getConfigInfoTool.d.ts +2 -0
- package/dist/mcp/builtin/getConfigInfoTool.d.ts.map +1 -0
- package/dist/mcp/builtin/getConfigInfoTool.js +69 -0
- package/dist/mcp/builtin/getConfigInfoTool.js.map +1 -0
- package/dist/mcp/builtin/globals/countVersionsTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/countVersionsTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/countVersionsTool.js +60 -0
- package/dist/mcp/builtin/globals/countVersionsTool.js.map +1 -0
- package/dist/mcp/builtin/globals/findTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/findTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/findTool.js +67 -0
- package/dist/mcp/builtin/globals/findTool.js.map +1 -0
- package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/findVersionByIDTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/findVersionByIDTool.js +68 -0
- package/dist/mcp/builtin/globals/findVersionByIDTool.js.map +1 -0
- package/dist/mcp/builtin/globals/findVersionsTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/findVersionsTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/findVersionsTool.js +78 -0
- package/dist/mcp/builtin/globals/findVersionsTool.js.map +1 -0
- package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/getGlobalSchemaTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/getGlobalSchemaTool.js +81 -0
- package/dist/mcp/builtin/globals/getGlobalSchemaTool.js.map +1 -0
- package/dist/mcp/builtin/globals/restoreVersionTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/restoreVersionTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/restoreVersionTool.js +70 -0
- package/dist/mcp/builtin/globals/restoreVersionTool.js.map +1 -0
- package/dist/mcp/builtin/globals/updateTool.d.ts +2 -0
- package/dist/mcp/builtin/globals/updateTool.d.ts.map +1 -0
- package/dist/mcp/builtin/globals/updateTool.js +78 -0
- package/dist/mcp/builtin/globals/updateTool.js.map +1 -0
- package/dist/mcp/builtinTools.d.ts +168 -0
- package/dist/mcp/builtinTools.d.ts.map +1 -0
- package/dist/mcp/builtinTools.js +169 -0
- package/dist/mcp/builtinTools.js.map +1 -0
- package/dist/mcp/sanitizeMCPConfig.d.ts +16 -0
- package/dist/mcp/sanitizeMCPConfig.d.ts.map +1 -0
- package/dist/mcp/sanitizeMCPConfig.js +236 -0
- package/dist/mcp/sanitizeMCPConfig.js.map +1 -0
- package/dist/stdio.d.ts +8 -0
- package/dist/stdio.d.ts.map +1 -0
- package/dist/stdio.js +128 -0
- package/dist/stdio.js.map +1 -0
- package/dist/types.d.ts +352 -441
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +4 -1
- package/dist/types.js.map +1 -1
- package/dist/utils/getLogger.d.ts +10 -0
- package/dist/utils/getLogger.d.ts.map +1 -0
- package/dist/utils/getLogger.js +22 -0
- package/dist/utils/getLogger.js.map +1 -0
- package/dist/utils/getPluginConfig.d.ts +12 -0
- package/dist/utils/getPluginConfig.d.ts.map +1 -0
- package/dist/utils/getPluginConfig.js +15 -0
- package/dist/utils/getPluginConfig.js.map +1 -0
- package/dist/utils/resolveProjectRoot.d.ts +7 -0
- package/dist/utils/resolveProjectRoot.d.ts.map +1 -0
- package/dist/utils/resolveProjectRoot.js +15 -0
- package/dist/utils/resolveProjectRoot.js.map +1 -0
- package/dist/utils/seal.d.ts +17 -0
- package/dist/utils/seal.d.ts.map +1 -0
- package/dist/utils/seal.js +24 -0
- package/dist/utils/seal.js.map +1 -0
- package/dist/utils/toStandardSchema.d.ts +5 -0
- package/dist/utils/toStandardSchema.d.ts.map +1 -0
- package/dist/utils/toStandardSchema.js +4 -0
- package/dist/utils/toStandardSchema.js.map +1 -0
- package/dist/views/Authorize/AllowButtons/index.d.ts +18 -0
- package/dist/views/Authorize/AllowButtons/index.d.ts.map +1 -0
- package/dist/views/Authorize/AllowButtons/index.js +88 -0
- package/dist/views/Authorize/AllowButtons/index.js.map +1 -0
- package/dist/views/Authorize/index.css +19 -0
- package/dist/views/Authorize/index.d.ts +9 -0
- package/dist/views/Authorize/index.d.ts.map +1 -0
- package/dist/views/Authorize/index.js +86 -0
- package/dist/views/Authorize/index.js.map +1 -0
- package/package.json +48 -26
- package/src/defaultAccess.ts +3 -0
- package/src/defineTool.ts +44 -0
- package/src/endpoint/access.ts +153 -0
- package/src/endpoint/index.ts +123 -0
- package/src/endpoint/oauth.ts +108 -0
- package/src/endpoint/oauthLoginToken.ts +94 -0
- package/src/endpoint/oauthServer.ts +452 -0
- package/src/exports/client.ts +3 -0
- package/src/exports/internal.ts +1 -0
- package/src/exports/rsc.ts +1 -0
- package/src/index.ts +74 -88
- package/src/mcp/buildMcpServer.ts +294 -0
- package/src/mcp/builtin/collections/authTools.ts +280 -0
- package/src/mcp/builtin/collections/countTool.ts +61 -0
- package/src/mcp/builtin/collections/countVersionsTool.ts +60 -0
- package/src/mcp/builtin/collections/createTool.ts +143 -0
- package/src/mcp/builtin/collections/deleteTool.ts +99 -0
- package/src/mcp/builtin/collections/duplicateTool.ts +84 -0
- package/src/mcp/builtin/collections/fileInput.spec.ts +93 -0
- package/src/mcp/builtin/collections/fileInput.ts +127 -0
- package/src/mcp/builtin/collections/findDistinctTool.ts +67 -0
- package/src/mcp/builtin/collections/findTool.ts +134 -0
- package/src/mcp/builtin/collections/findVersionByIDTool.ts +66 -0
- package/src/mcp/builtin/collections/findVersionsTool.ts +83 -0
- package/src/mcp/builtin/collections/getCollectionSchemaTool.ts +91 -0
- package/src/mcp/builtin/collections/restoreVersionTool.ts +65 -0
- package/src/mcp/builtin/collections/updateTool.ts +173 -0
- package/src/mcp/builtin/collections/uploadInstructionsTool.ts +64 -0
- package/src/mcp/builtin/formatEntityError.ts +77 -0
- package/src/mcp/builtin/getConfigInfoTool.ts +68 -0
- package/src/mcp/builtin/globals/countVersionsTool.ts +60 -0
- package/src/mcp/builtin/globals/findTool.ts +66 -0
- package/src/mcp/builtin/globals/findVersionByIDTool.ts +64 -0
- package/src/mcp/builtin/globals/findVersionsTool.ts +69 -0
- package/src/mcp/builtin/globals/getGlobalSchemaTool.ts +73 -0
- package/src/mcp/builtin/globals/restoreVersionTool.ts +68 -0
- package/src/mcp/builtin/globals/updateTool.ts +92 -0
- package/src/mcp/builtinTools.ts +161 -0
- package/src/mcp/sanitizeMCPConfig.ts +282 -0
- package/src/stdio.ts +131 -0
- package/src/types.ts +401 -481
- package/src/utils/getLogger.ts +22 -0
- package/src/utils/getPluginConfig.ts +24 -0
- package/src/utils/resolveProjectRoot.ts +17 -0
- package/src/utils/seal.ts +46 -0
- package/src/utils/toStandardSchema.ts +9 -0
- package/src/views/Authorize/AllowButtons/index.tsx +97 -0
- package/src/views/Authorize/index.css +19 -0
- package/src/views/Authorize/index.tsx +93 -0
- package/dist/collections/createApiKeysCollection.d.ts +0 -7
- package/dist/collections/createApiKeysCollection.d.ts.map +0 -1
- package/dist/collections/createApiKeysCollection.js +0 -317
- package/dist/collections/createApiKeysCollection.js.map +0 -1
- package/dist/defaults.d.ts +0 -4
- package/dist/defaults.d.ts.map +0 -1
- package/dist/defaults.js +0 -5
- package/dist/defaults.js.map +0 -1
- package/dist/endpoints/mcp.d.ts +0 -4
- package/dist/endpoints/mcp.d.ts.map +0 -1
- package/dist/endpoints/mcp.js +0 -71
- package/dist/endpoints/mcp.js.map +0 -1
- package/dist/mcp/createRequest.d.ts +0 -3
- package/dist/mcp/createRequest.d.ts.map +0 -1
- package/dist/mcp/createRequest.js +0 -14
- package/dist/mcp/createRequest.js.map +0 -1
- package/dist/mcp/getMcpHandler.d.ts +0 -4
- package/dist/mcp/getMcpHandler.d.ts.map +0 -1
- package/dist/mcp/getMcpHandler.js +0 -231
- package/dist/mcp/getMcpHandler.js.map +0 -1
- package/dist/mcp/helpers/config.d.ts +0 -22
- package/dist/mcp/helpers/config.d.ts.map +0 -1
- package/dist/mcp/helpers/config.js +0 -153
- package/dist/mcp/helpers/config.js.map +0 -1
- package/dist/mcp/helpers/fields.d.ts +0 -19
- package/dist/mcp/helpers/fields.d.ts.map +0 -1
- package/dist/mcp/helpers/fields.js +0 -102
- package/dist/mcp/helpers/fields.js.map +0 -1
- package/dist/mcp/helpers/fileValidation.d.ts +0 -67
- package/dist/mcp/helpers/fileValidation.d.ts.map +0 -1
- package/dist/mcp/helpers/fileValidation.js +0 -267
- package/dist/mcp/helpers/fileValidation.js.map +0 -1
- package/dist/mcp/registerTool.d.ts +0 -6
- package/dist/mcp/registerTool.d.ts.map +0 -1
- package/dist/mcp/registerTool.js +0 -18
- package/dist/mcp/registerTool.js.map +0 -1
- package/dist/mcp/tools/auth/auth.d.ts +0 -4
- package/dist/mcp/tools/auth/auth.d.ts.map +0 -1
- package/dist/mcp/tools/auth/auth.js +0 -57
- package/dist/mcp/tools/auth/auth.js.map +0 -1
- package/dist/mcp/tools/auth/forgotPassword.d.ts +0 -4
- package/dist/mcp/tools/auth/forgotPassword.d.ts.map +0 -1
- package/dist/mcp/tools/auth/forgotPassword.js +0 -48
- package/dist/mcp/tools/auth/forgotPassword.js.map +0 -1
- package/dist/mcp/tools/auth/login.d.ts +0 -4
- package/dist/mcp/tools/auth/login.d.ts.map +0 -1
- package/dist/mcp/tools/auth/login.js +0 -51
- package/dist/mcp/tools/auth/login.js.map +0 -1
- package/dist/mcp/tools/auth/resetPassword.d.ts +0 -4
- package/dist/mcp/tools/auth/resetPassword.d.ts.map +0 -1
- package/dist/mcp/tools/auth/resetPassword.js +0 -49
- package/dist/mcp/tools/auth/resetPassword.js.map +0 -1
- package/dist/mcp/tools/auth/unlock.d.ts +0 -4
- package/dist/mcp/tools/auth/unlock.d.ts.map +0 -1
- package/dist/mcp/tools/auth/unlock.js +0 -48
- package/dist/mcp/tools/auth/unlock.js.map +0 -1
- package/dist/mcp/tools/auth/verify.d.ts +0 -4
- package/dist/mcp/tools/auth/verify.d.ts.map +0 -1
- package/dist/mcp/tools/auth/verify.js +0 -45
- package/dist/mcp/tools/auth/verify.js.map +0 -1
- package/dist/mcp/tools/collection/create.d.ts +0 -10
- package/dist/mcp/tools/collection/create.d.ts.map +0 -1
- package/dist/mcp/tools/collection/create.js +0 -139
- package/dist/mcp/tools/collection/create.js.map +0 -1
- package/dist/mcp/tools/collection/delete.d.ts +0 -10
- package/dist/mcp/tools/collection/delete.d.ts.map +0 -1
- package/dist/mcp/tools/collection/delete.js +0 -154
- package/dist/mcp/tools/collection/delete.js.map +0 -1
- package/dist/mcp/tools/collection/find.d.ts +0 -10
- package/dist/mcp/tools/collection/find.d.ts.map +0 -1
- package/dist/mcp/tools/collection/find.js +0 -165
- package/dist/mcp/tools/collection/find.js.map +0 -1
- package/dist/mcp/tools/collection/update.d.ts +0 -10
- package/dist/mcp/tools/collection/update.d.ts.map +0 -1
- package/dist/mcp/tools/collection/update.js +0 -209
- package/dist/mcp/tools/collection/update.js.map +0 -1
- package/dist/mcp/tools/config/find.d.ts +0 -10
- package/dist/mcp/tools/config/find.d.ts.map +0 -1
- package/dist/mcp/tools/config/find.js +0 -97
- package/dist/mcp/tools/config/find.js.map +0 -1
- package/dist/mcp/tools/config/update.d.ts +0 -10
- package/dist/mcp/tools/config/update.d.ts.map +0 -1
- package/dist/mcp/tools/config/update.js +0 -215
- package/dist/mcp/tools/config/update.js.map +0 -1
- package/dist/mcp/tools/global/find.d.ts +0 -5
- package/dist/mcp/tools/global/find.d.ts.map +0 -1
- package/dist/mcp/tools/global/find.js +0 -82
- package/dist/mcp/tools/global/find.js.map +0 -1
- package/dist/mcp/tools/global/update.d.ts +0 -6
- package/dist/mcp/tools/global/update.d.ts.map +0 -1
- package/dist/mcp/tools/global/update.js +0 -124
- package/dist/mcp/tools/global/update.js.map +0 -1
- package/dist/mcp/tools/job/create.d.ts +0 -10
- package/dist/mcp/tools/job/create.d.ts.map +0 -1
- package/dist/mcp/tools/job/create.js +0 -293
- package/dist/mcp/tools/job/create.js.map +0 -1
- package/dist/mcp/tools/job/run.d.ts +0 -10
- package/dist/mcp/tools/job/run.d.ts.map +0 -1
- package/dist/mcp/tools/job/run.js +0 -129
- package/dist/mcp/tools/job/run.js.map +0 -1
- package/dist/mcp/tools/job/update.d.ts +0 -11
- package/dist/mcp/tools/job/update.d.ts.map +0 -1
- package/dist/mcp/tools/job/update.js +0 -186
- package/dist/mcp/tools/job/update.js.map +0 -1
- package/dist/mcp/tools/resource/create.d.ts +0 -6
- package/dist/mcp/tools/resource/create.d.ts.map +0 -1
- package/dist/mcp/tools/resource/create.js +0 -124
- package/dist/mcp/tools/resource/create.js.map +0 -1
- package/dist/mcp/tools/resource/delete.d.ts +0 -5
- package/dist/mcp/tools/resource/delete.d.ts.map +0 -1
- package/dist/mcp/tools/resource/delete.js +0 -151
- package/dist/mcp/tools/resource/delete.js.map +0 -1
- package/dist/mcp/tools/resource/find.d.ts +0 -5
- package/dist/mcp/tools/resource/find.d.ts.map +0 -1
- package/dist/mcp/tools/resource/find.js +0 -170
- package/dist/mcp/tools/resource/find.js.map +0 -1
- package/dist/mcp/tools/resource/update.d.ts +0 -6
- package/dist/mcp/tools/resource/update.d.ts.map +0 -1
- package/dist/mcp/tools/resource/update.js +0 -256
- package/dist/mcp/tools/resource/update.js.map +0 -1
- package/dist/mcp/tools/schemas.d.ts +0 -457
- package/dist/mcp/tools/schemas.d.ts.map +0 -1
- package/dist/mcp/tools/schemas.js +0 -243
- package/dist/mcp/tools/schemas.js.map +0 -1
- package/dist/utils/adminEntitySettings.d.ts +0 -17
- package/dist/utils/adminEntitySettings.d.ts.map +0 -1
- package/dist/utils/adminEntitySettings.js +0 -41
- package/dist/utils/adminEntitySettings.js.map +0 -1
- package/dist/utils/createApiKeyFields.d.ts +0 -15
- package/dist/utils/createApiKeyFields.d.ts.map +0 -1
- package/dist/utils/createApiKeyFields.js +0 -57
- package/dist/utils/createApiKeyFields.js.map +0 -1
- package/dist/utils/getEnabledSlugs.d.ts +0 -13
- package/dist/utils/getEnabledSlugs.d.ts.map +0 -1
- package/dist/utils/getEnabledSlugs.js +0 -32
- package/dist/utils/getEnabledSlugs.js.map +0 -1
- package/dist/utils/getVirtualFieldNames.d.ts +0 -14
- package/dist/utils/getVirtualFieldNames.d.ts.map +0 -1
- package/dist/utils/getVirtualFieldNames.js +0 -35
- package/dist/utils/getVirtualFieldNames.js.map +0 -1
- package/dist/utils/schemaConversion/convertCollectionSchemaToZod.d.ts +0 -3
- package/dist/utils/schemaConversion/convertCollectionSchemaToZod.d.ts.map +0 -1
- package/dist/utils/schemaConversion/convertCollectionSchemaToZod.js +0 -43
- package/dist/utils/schemaConversion/convertCollectionSchemaToZod.js.map +0 -1
- package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts +0 -7
- package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.d.ts.map +0 -1
- package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js +0 -20
- package/dist/utils/schemaConversion/removeVirtualFieldsFromSchema.js.map +0 -1
- package/dist/utils/schemaConversion/sanitizeJsonSchema.d.ts +0 -13
- package/dist/utils/schemaConversion/sanitizeJsonSchema.d.ts.map +0 -1
- package/dist/utils/schemaConversion/sanitizeJsonSchema.js +0 -56
- package/dist/utils/schemaConversion/sanitizeJsonSchema.js.map +0 -1
- package/dist/utils/schemaConversion/simplifyRelationshipFields.d.ts +0 -20
- package/dist/utils/schemaConversion/simplifyRelationshipFields.d.ts.map +0 -1
- package/dist/utils/schemaConversion/simplifyRelationshipFields.js +0 -53
- package/dist/utils/schemaConversion/simplifyRelationshipFields.js.map +0 -1
- package/dist/utils/schemaConversion/transformPointFields.d.ts +0 -3
- package/dist/utils/schemaConversion/transformPointFields.d.ts.map +0 -1
- package/dist/utils/schemaConversion/transformPointFields.js +0 -51
- package/dist/utils/schemaConversion/transformPointFields.js.map +0 -1
- package/dist/utils/transformPointDataToPayload.d.ts +0 -7
- package/dist/utils/transformPointDataToPayload.d.ts.map +0 -1
- package/dist/utils/transformPointDataToPayload.js +0 -28
- package/dist/utils/transformPointDataToPayload.js.map +0 -1
- package/src/collections/createApiKeysCollection.ts +0 -373
- package/src/defaults.ts +0 -3
- package/src/endpoints/mcp.ts +0 -91
- package/src/mcp/createRequest.ts +0 -13
- package/src/mcp/getMcpHandler.ts +0 -545
- package/src/mcp/helpers/config.ts +0 -213
- package/src/mcp/helpers/fields.ts +0 -154
- package/src/mcp/helpers/fileValidation.ts +0 -362
- package/src/mcp/registerTool.ts +0 -22
- package/src/mcp/tools/auth/auth.ts +0 -71
- package/src/mcp/tools/auth/forgotPassword.ts +0 -70
- package/src/mcp/tools/auth/login.ts +0 -72
- package/src/mcp/tools/auth/resetPassword.ts +0 -61
- package/src/mcp/tools/auth/unlock.ts +0 -64
- package/src/mcp/tools/auth/verify.ts +0 -57
- package/src/mcp/tools/collection/create.ts +0 -210
- package/src/mcp/tools/collection/delete.ts +0 -211
- package/src/mcp/tools/collection/find.ts +0 -224
- package/src/mcp/tools/collection/update.ts +0 -290
- package/src/mcp/tools/config/find.ts +0 -128
- package/src/mcp/tools/config/update.ts +0 -280
- package/src/mcp/tools/global/find.ts +0 -128
- package/src/mcp/tools/global/update.ts +0 -207
- package/src/mcp/tools/job/create.ts +0 -416
- package/src/mcp/tools/job/run.ts +0 -167
- package/src/mcp/tools/job/update.ts +0 -274
- package/src/mcp/tools/resource/create.ts +0 -211
- package/src/mcp/tools/resource/delete.ts +0 -218
- package/src/mcp/tools/resource/find.ts +0 -246
- package/src/mcp/tools/resource/update.ts +0 -383
- package/src/mcp/tools/schemas.ts +0 -520
- package/src/utils/adminEntitySettings.ts +0 -40
- package/src/utils/createApiKeyFields.ts +0 -72
- package/src/utils/getEnabledSlugs.ts +0 -42
- package/src/utils/getVirtualFieldNames.ts +0 -53
- package/src/utils/schemaConversion/convertCollectionSchemaToZod.ts +0 -52
- package/src/utils/schemaConversion/removeVirtualFieldsFromSchema.ts +0 -27
- package/src/utils/schemaConversion/sanitizeJsonSchema.ts +0 -62
- package/src/utils/schemaConversion/simplifyRelationshipFields.ts +0 -65
- package/src/utils/schemaConversion/transformPointFields.ts +0 -55
- package/src/utils/transformPointDataToPayload.ts +0 -40
package/LICENSE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
MIT License
|
|
2
2
|
|
|
3
|
-
Copyright (c) 2018-
|
|
3
|
+
Copyright (c) 2018-2026 Payload CMS, LLC <info@payloadcms.com>
|
|
4
4
|
|
|
5
5
|
Permission is hereby granted, free of charge, to any person obtaining
|
|
6
6
|
a copy of this software and associated documentation files (the
|
package/bin.js
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* stdio MCP server for Payload.
|
|
4
|
+
*
|
|
5
|
+
* Loads the project's `payload.config.{ts,js}` (via `findConfig`), boots Payload,
|
|
6
|
+
* and serves MCP over stdin/stdout. Intended for local-dev MCP clients (Claude
|
|
7
|
+
* Desktop, IDEs) that spawn stdio MCP servers - no running Next.js dev server required.
|
|
8
|
+
*
|
|
9
|
+
* Mirrors `payload/bin.js`: by default, transpiles TS on the fly via `tsx`. Pass
|
|
10
|
+
* `--disable-transpile` if your config is already JS (or you've registered your
|
|
11
|
+
* own loader).
|
|
12
|
+
*/
|
|
13
|
+
import path from 'path'
|
|
14
|
+
import { fileURLToPath, pathToFileURL } from 'url'
|
|
15
|
+
|
|
16
|
+
const disableTranspile = process.argv.includes('--disable-transpile')
|
|
17
|
+
|
|
18
|
+
const filename = fileURLToPath(import.meta.url)
|
|
19
|
+
const dirname = path.dirname(filename)
|
|
20
|
+
const baseURL = pathToFileURL(dirname).toString() + '/'
|
|
21
|
+
|
|
22
|
+
const start = async () => {
|
|
23
|
+
if (disableTranspile) {
|
|
24
|
+
process.argv = process.argv.filter((arg) => arg !== '--disable-transpile')
|
|
25
|
+
const { runMcpStdio } = await import('./dist/stdio.js')
|
|
26
|
+
await runMcpStdio()
|
|
27
|
+
return
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const { tsImport } = await import('tsx/esm/api')
|
|
31
|
+
const { runMcpStdio } = await tsImport('./dist/stdio.js', baseURL)
|
|
32
|
+
await runMcpStdio()
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
start().catch((err) => {
|
|
36
|
+
// eslint-disable-next-line no-console
|
|
37
|
+
console.error('[payload-mcp] error:', err)
|
|
38
|
+
process.exit(1)
|
|
39
|
+
})
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defaultAccess.d.ts","sourceRoot":"","sources":["../src/defaultAccess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,eAAO,MAAM,aAAa,YAAa,aAAa,KAAG,OAA4B,CAAA"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/defaultAccess.ts"],"sourcesContent":["import type { MCPAccessArgs } from './types.js'\n\nexport const defaultAccess = ({ req }: MCPAccessArgs): boolean => Boolean(req.user)\n"],"names":["defaultAccess","req","Boolean","user"],"mappings":"AAEA,OAAO,MAAMA,gBAAgB,CAAC,EAAEC,GAAG,EAAiB,GAAcC,QAAQD,IAAIE,IAAI,EAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { CollectionTool, GlobalTool, Prompt, Tool, ToolInputSchema } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Two-stage builder: pass the schema/metadata first, then chain `.handler(fn)`. Splitting the
|
|
4
|
+
* call lets TypeScript resolve `TSchema` from `input` (call 1) before contextually typing the
|
|
5
|
+
* handler (call 2). A single-call API hit a TS limitation where property order in the literal
|
|
6
|
+
* decided whether `TSchema` was inferred or pinned to its default.
|
|
7
|
+
*
|
|
8
|
+
* defineCollectionTool({ description, input })
|
|
9
|
+
* .handler(({ input }) => …) // ← input is fully typed here regardless of order
|
|
10
|
+
*
|
|
11
|
+
* Config and handler signatures are derived from `Tool` / `CollectionTool` / `GlobalTool` /
|
|
12
|
+
* `Prompt` via `Omit` + indexed access so there's no duplication with `types.ts`.
|
|
13
|
+
*/
|
|
14
|
+
export declare const defineTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<Tool<TSchema>, 'handler'>) => {
|
|
15
|
+
handler: (fn: Tool<TSchema>['handler']) => Tool;
|
|
16
|
+
};
|
|
17
|
+
export declare const defineCollectionTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<CollectionTool<TSchema>, 'handler'>) => {
|
|
18
|
+
handler: (fn: CollectionTool<TSchema>['handler']) => CollectionTool;
|
|
19
|
+
};
|
|
20
|
+
export declare const defineGlobalTool: <TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined>(args: Omit<GlobalTool<TSchema>, 'handler'>) => {
|
|
21
|
+
handler: (fn: GlobalTool<TSchema>['handler']) => GlobalTool;
|
|
22
|
+
};
|
|
23
|
+
export declare const definePrompt: <TSchema extends ToolInputSchema = ToolInputSchema>(args: Omit<Prompt<TSchema>, 'handler'>) => {
|
|
24
|
+
handler: (fn: Prompt<TSchema>['handler']) => Prompt;
|
|
25
|
+
};
|
|
26
|
+
//# sourceMappingURL=defineTool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../src/defineTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE3F;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,UAAU,GACrB,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,QAEnE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACnC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAA;CAElD,CAAA;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,QAEnE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAC7C;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,cAAc,CAAA;CAEtE,CAAA;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,QAEnE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACzC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,UAAU,CAAA;CAE9D,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,eAAe,GAAG,eAAe,QACtE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KACrC;IAAE,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,MAAM,CAAA;CAEtD,CAAA"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Two-stage builder: pass the schema/metadata first, then chain `.handler(fn)`. Splitting the
|
|
3
|
+
* call lets TypeScript resolve `TSchema` from `input` (call 1) before contextually typing the
|
|
4
|
+
* handler (call 2). A single-call API hit a TS limitation where property order in the literal
|
|
5
|
+
* decided whether `TSchema` was inferred or pinned to its default.
|
|
6
|
+
*
|
|
7
|
+
* defineCollectionTool({ description, input })
|
|
8
|
+
* .handler(({ input }) => …) // ← input is fully typed here regardless of order
|
|
9
|
+
*
|
|
10
|
+
* Config and handler signatures are derived from `Tool` / `CollectionTool` / `GlobalTool` /
|
|
11
|
+
* `Prompt` via `Omit` + indexed access so there's no duplication with `types.ts`.
|
|
12
|
+
*/ export const defineTool = (args)=>({
|
|
13
|
+
handler: (fn)=>({
|
|
14
|
+
...args,
|
|
15
|
+
handler: fn
|
|
16
|
+
})
|
|
17
|
+
});
|
|
18
|
+
export const defineCollectionTool = (args)=>({
|
|
19
|
+
handler: (fn)=>({
|
|
20
|
+
...args,
|
|
21
|
+
handler: fn
|
|
22
|
+
})
|
|
23
|
+
});
|
|
24
|
+
export const defineGlobalTool = (args)=>({
|
|
25
|
+
handler: (fn)=>({
|
|
26
|
+
...args,
|
|
27
|
+
handler: fn
|
|
28
|
+
})
|
|
29
|
+
});
|
|
30
|
+
export const definePrompt = (args)=>({
|
|
31
|
+
handler: (fn)=>({
|
|
32
|
+
...args,
|
|
33
|
+
handler: fn
|
|
34
|
+
})
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
//# sourceMappingURL=defineTool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/defineTool.ts"],"sourcesContent":["import type { CollectionTool, GlobalTool, Prompt, Tool, ToolInputSchema } from './types.js'\n\n/**\n * Two-stage builder: pass the schema/metadata first, then chain `.handler(fn)`. Splitting the\n * call lets TypeScript resolve `TSchema` from `input` (call 1) before contextually typing the\n * handler (call 2). A single-call API hit a TS limitation where property order in the literal\n * decided whether `TSchema` was inferred or pinned to its default.\n *\n * defineCollectionTool({ description, input })\n * .handler(({ input }) => …) // ← input is fully typed here regardless of order\n *\n * Config and handler signatures are derived from `Tool` / `CollectionTool` / `GlobalTool` /\n * `Prompt` via `Omit` + indexed access so there's no duplication with `types.ts`.\n */\n\nexport const defineTool = <\n TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined,\n>(\n args: Omit<Tool<TSchema>, 'handler'>,\n): { handler: (fn: Tool<TSchema>['handler']) => Tool } => ({\n handler: (fn) => ({ ...args, handler: fn }) as unknown as Tool,\n})\n\nexport const defineCollectionTool = <\n TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined,\n>(\n args: Omit<CollectionTool<TSchema>, 'handler'>,\n): { handler: (fn: CollectionTool<TSchema>['handler']) => CollectionTool } => ({\n handler: (fn) => ({ ...args, handler: fn }) as unknown as CollectionTool,\n})\n\nexport const defineGlobalTool = <\n TSchema extends ToolInputSchema | undefined = ToolInputSchema | undefined,\n>(\n args: Omit<GlobalTool<TSchema>, 'handler'>,\n): { handler: (fn: GlobalTool<TSchema>['handler']) => GlobalTool } => ({\n handler: (fn) => ({ ...args, handler: fn }) as unknown as GlobalTool,\n})\n\nexport const definePrompt = <TSchema extends ToolInputSchema = ToolInputSchema>(\n args: Omit<Prompt<TSchema>, 'handler'>,\n): { handler: (fn: Prompt<TSchema>['handler']) => Prompt } => ({\n handler: (fn) => ({ ...args, handler: fn }) as unknown as Prompt,\n})\n"],"names":["defineTool","args","handler","fn","defineCollectionTool","defineGlobalTool","definePrompt"],"mappings":"AAEA;;;;;;;;;;;CAWC,GAED,OAAO,MAAMA,aAAa,CAGxBC,OACyD,CAAA;QACzDC,SAAS,CAACC,KAAQ,CAAA;gBAAE,GAAGF,IAAI;gBAAEC,SAASC;YAAG,CAAA;IAC3C,CAAA,EAAE;AAEF,OAAO,MAAMC,uBAAuB,CAGlCH,OAC6E,CAAA;QAC7EC,SAAS,CAACC,KAAQ,CAAA;gBAAE,GAAGF,IAAI;gBAAEC,SAASC;YAAG,CAAA;IAC3C,CAAA,EAAE;AAEF,OAAO,MAAME,mBAAmB,CAG9BJ,OACqE,CAAA;QACrEC,SAAS,CAACC,KAAQ,CAAA;gBAAE,GAAGF,IAAI;gBAAEC,SAASC;YAAG,CAAA;IAC3C,CAAA,EAAE;AAEF,OAAO,MAAMG,eAAe,CAC1BL,OAC6D,CAAA;QAC7DC,SAAS,CAACC,KAAQ,CAAA;gBAAE,GAAGF,IAAI;gBAAEC,SAASC;YAAG,CAAA;IAC3C,CAAA,EAAE"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { PayloadRequest } from 'payload';
|
|
2
|
+
import type { AuthorizedMCP, MCPItem } from '../types.js';
|
|
3
|
+
export type GetAuthorizedMCPArgs = {
|
|
4
|
+
/**
|
|
5
|
+
* Whether the request came through the HTTP endpoint, whose response can carry the OAuth
|
|
6
|
+
* challenge and headers from auth strategies. stdio has no response to carry them.
|
|
7
|
+
*/
|
|
8
|
+
isHTTP?: boolean;
|
|
9
|
+
overrideAccess: boolean;
|
|
10
|
+
req: PayloadRequest;
|
|
11
|
+
};
|
|
12
|
+
/**
|
|
13
|
+
* Authenticates an MCP request and removes items the user cannot access.
|
|
14
|
+
* `overrideAccess` skips Payload and MCP item access checks.
|
|
15
|
+
*/
|
|
16
|
+
export declare const getAuthorizedMCP: (args: GetAuthorizedMCPArgs) => Promise<AuthorizedMCP>;
|
|
17
|
+
export declare const filterMCPItems: ({ items, overrideAccess, req, }: {
|
|
18
|
+
items: MCPItem[];
|
|
19
|
+
overrideAccess: boolean;
|
|
20
|
+
req: PayloadRequest;
|
|
21
|
+
}) => Promise<MCPItem[]>;
|
|
22
|
+
//# sourceMappingURL=access.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/endpoint/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,SAAS,CAAA;AAKnE,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAKzD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;IACvB,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,aAAa,CAqEnF,CAAA;AAED,eAAO,MAAM,cAAc,oCAIxB;IACD,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;IACvB,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,OAAO,CAAC,OAAO,EAAE,CAkBpB,CAAA"}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
import { executeAuthStrategies, getAccessResults, UnauthorizedError } from 'payload';
|
|
2
|
+
import { extractBearerToken } from 'payload/shared';
|
|
3
|
+
import { getPluginConfig } from '../utils/getPluginConfig.js';
|
|
4
|
+
import { authenticateLoginToken } from './oauthLoginToken.js';
|
|
5
|
+
/**
|
|
6
|
+
* Authenticates an MCP request and removes items the user cannot access.
|
|
7
|
+
* `overrideAccess` skips Payload and MCP item access checks.
|
|
8
|
+
*/ export const getAuthorizedMCP = async ({ isHTTP = false, overrideAccess, req })=>{
|
|
9
|
+
const pluginConfig = getPluginConfig({
|
|
10
|
+
config: req.payload.config
|
|
11
|
+
});
|
|
12
|
+
const isChallengedWhenSignedOut = isHTTP && Boolean(pluginConfig.oauth);
|
|
13
|
+
if (pluginConfig.overrideGetAuthorizedMCP) {
|
|
14
|
+
return await pluginConfig.overrideGetAuthorizedMCP({
|
|
15
|
+
overrideAccess,
|
|
16
|
+
pluginConfig,
|
|
17
|
+
req
|
|
18
|
+
});
|
|
19
|
+
}
|
|
20
|
+
if (req.headers) {
|
|
21
|
+
const headers = new Headers(req.headers);
|
|
22
|
+
const hasAuthorization = headers.has('Authorization');
|
|
23
|
+
headers.set('DisableAutologin', 'true');
|
|
24
|
+
// Not `payload.auth()`, which also computes permissions that filterMCPItems computes anyway
|
|
25
|
+
const { responseHeaders, user } = await executeAuthStrategies({
|
|
26
|
+
canSetHeaders: isHTTP,
|
|
27
|
+
headers,
|
|
28
|
+
payload: req.payload,
|
|
29
|
+
req
|
|
30
|
+
});
|
|
31
|
+
req.user = user;
|
|
32
|
+
if (responseHeaders) {
|
|
33
|
+
req.responseHeaders = responseHeaders;
|
|
34
|
+
}
|
|
35
|
+
// Only bearer tokens that no auth strategy accepted get here, e.g. an OAuth access token.
|
|
36
|
+
// API keys use the `<collection> API-Key <key>` scheme instead of `Bearer`, so they never do.
|
|
37
|
+
const bearerToken = extractBearerToken({
|
|
38
|
+
headers
|
|
39
|
+
});
|
|
40
|
+
// Sealed Payload login tokens from the built-in OAuth server
|
|
41
|
+
if (!req.user && bearerToken && pluginConfig.oauth?.type === 'builtin' && !pluginConfig.oauth.issueToken) {
|
|
42
|
+
req.user = await authenticateLoginToken({
|
|
43
|
+
req,
|
|
44
|
+
token: bearerToken
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
if (!req.user && bearerToken && pluginConfig.oauth?.authenticate) {
|
|
48
|
+
req.user = await pluginConfig.oauth.authenticate({
|
|
49
|
+
req,
|
|
50
|
+
token: bearerToken
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
// With OAuth, the endpoint answers with a challenge that starts the client's sign-in
|
|
54
|
+
if (hasAuthorization && !req.user && !isChallengedWhenSignedOut) {
|
|
55
|
+
throw new UnauthorizedError(req.t);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
// Signed-out users only get the challenge, so they can't use any MCP items. Skipping the access
|
|
59
|
+
// checks saves work, and access callbacks only see signed-in users.
|
|
60
|
+
if (isChallengedWhenSignedOut && !req.user) {
|
|
61
|
+
return {
|
|
62
|
+
items: [],
|
|
63
|
+
overrideAccess
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
return {
|
|
67
|
+
items: await filterMCPItems({
|
|
68
|
+
items: pluginConfig.items,
|
|
69
|
+
overrideAccess,
|
|
70
|
+
req
|
|
71
|
+
}),
|
|
72
|
+
overrideAccess
|
|
73
|
+
};
|
|
74
|
+
};
|
|
75
|
+
export const filterMCPItems = async ({ items, overrideAccess, req })=>{
|
|
76
|
+
// Match Payload core: overrideAccess bypasses access evaluation
|
|
77
|
+
if (overrideAccess) {
|
|
78
|
+
return items;
|
|
79
|
+
}
|
|
80
|
+
const authorizedItems = [];
|
|
81
|
+
const permissions = await getAccessResults({
|
|
82
|
+
req
|
|
83
|
+
});
|
|
84
|
+
for (const item of items){
|
|
85
|
+
if (!await checkItemAccess({
|
|
86
|
+
item,
|
|
87
|
+
permissions,
|
|
88
|
+
req
|
|
89
|
+
})) {
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
authorizedItems.push(item);
|
|
93
|
+
}
|
|
94
|
+
return authorizedItems;
|
|
95
|
+
};
|
|
96
|
+
/**
|
|
97
|
+
* Runs MCP item access callbacks
|
|
98
|
+
*/ const checkItemAccess = async ({ item, permissions, req })=>{
|
|
99
|
+
switch(item.type){
|
|
100
|
+
case 'collectionTool':
|
|
101
|
+
return !item.tool.access || await item.tool.access({
|
|
102
|
+
slug: item.collectionSlug,
|
|
103
|
+
permissions,
|
|
104
|
+
req
|
|
105
|
+
});
|
|
106
|
+
case 'globalTool':
|
|
107
|
+
return !item.tool.access || await item.tool.access({
|
|
108
|
+
slug: item.globalSlug,
|
|
109
|
+
permissions,
|
|
110
|
+
req
|
|
111
|
+
});
|
|
112
|
+
case 'prompt':
|
|
113
|
+
return !item.prompt.access || await item.prompt.access({
|
|
114
|
+
permissions,
|
|
115
|
+
req
|
|
116
|
+
});
|
|
117
|
+
case 'resource':
|
|
118
|
+
return !item.resource.access || await item.resource.access({
|
|
119
|
+
permissions,
|
|
120
|
+
req
|
|
121
|
+
});
|
|
122
|
+
case 'tool':
|
|
123
|
+
return !item.tool.access || await item.tool.access({
|
|
124
|
+
permissions,
|
|
125
|
+
req
|
|
126
|
+
});
|
|
127
|
+
}
|
|
128
|
+
};
|
|
129
|
+
|
|
130
|
+
//# sourceMappingURL=access.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/endpoint/access.ts"],"sourcesContent":["import type { PayloadRequest, SanitizedPermissions } from 'payload'\n\nimport { executeAuthStrategies, getAccessResults, UnauthorizedError } from 'payload'\nimport { extractBearerToken } from 'payload/shared'\n\nimport type { AuthorizedMCP, MCPItem } from '../types.js'\n\nimport { getPluginConfig } from '../utils/getPluginConfig.js'\nimport { authenticateLoginToken } from './oauthLoginToken.js'\n\nexport type GetAuthorizedMCPArgs = {\n /**\n * Whether the request came through the HTTP endpoint, whose response can carry the OAuth\n * challenge and headers from auth strategies. stdio has no response to carry them.\n */\n isHTTP?: boolean\n overrideAccess: boolean\n req: PayloadRequest\n}\n\n/**\n * Authenticates an MCP request and removes items the user cannot access.\n * `overrideAccess` skips Payload and MCP item access checks.\n */\nexport const getAuthorizedMCP: (args: GetAuthorizedMCPArgs) => Promise<AuthorizedMCP> = async ({\n isHTTP = false,\n overrideAccess,\n req,\n}) => {\n const pluginConfig = getPluginConfig({ config: req.payload.config })\n const isChallengedWhenSignedOut = isHTTP && Boolean(pluginConfig.oauth)\n\n if (pluginConfig.overrideGetAuthorizedMCP) {\n return await pluginConfig.overrideGetAuthorizedMCP({\n overrideAccess,\n pluginConfig,\n req,\n })\n }\n\n if (req.headers) {\n const headers = new Headers(req.headers)\n const hasAuthorization = headers.has('Authorization')\n\n headers.set('DisableAutologin', 'true')\n // Not `payload.auth()`, which also computes permissions that filterMCPItems computes anyway\n const { responseHeaders, user } = await executeAuthStrategies({\n canSetHeaders: isHTTP,\n headers,\n payload: req.payload,\n req,\n })\n req.user = user\n if (responseHeaders) {\n req.responseHeaders = responseHeaders\n }\n\n // Only bearer tokens that no auth strategy accepted get here, e.g. an OAuth access token.\n // API keys use the `<collection> API-Key <key>` scheme instead of `Bearer`, so they never do.\n const bearerToken = extractBearerToken({ headers })\n // Sealed Payload login tokens from the built-in OAuth server\n if (\n !req.user &&\n bearerToken &&\n pluginConfig.oauth?.type === 'builtin' &&\n !pluginConfig.oauth.issueToken\n ) {\n req.user = await authenticateLoginToken({ req, token: bearerToken })\n }\n if (!req.user && bearerToken && pluginConfig.oauth?.authenticate) {\n req.user = await pluginConfig.oauth.authenticate({ req, token: bearerToken })\n }\n\n // With OAuth, the endpoint answers with a challenge that starts the client's sign-in\n if (hasAuthorization && !req.user && !isChallengedWhenSignedOut) {\n throw new UnauthorizedError(req.t)\n }\n }\n\n // Signed-out users only get the challenge, so they can't use any MCP items. Skipping the access\n // checks saves work, and access callbacks only see signed-in users.\n if (isChallengedWhenSignedOut && !req.user) {\n return { items: [], overrideAccess }\n }\n\n return {\n items: await filterMCPItems({\n items: pluginConfig.items,\n overrideAccess,\n req,\n }),\n overrideAccess,\n }\n}\n\nexport const filterMCPItems = async ({\n items,\n overrideAccess,\n req,\n}: {\n items: MCPItem[]\n overrideAccess: boolean\n req: PayloadRequest\n}): Promise<MCPItem[]> => {\n // Match Payload core: overrideAccess bypasses access evaluation\n if (overrideAccess) {\n return items\n }\n\n const authorizedItems: MCPItem[] = []\n\n const permissions = await getAccessResults({ req })\n\n for (const item of items) {\n if (!(await checkItemAccess({ item, permissions, req }))) {\n continue\n }\n authorizedItems.push(item)\n }\n\n return authorizedItems\n}\n\n/**\n * Runs MCP item access callbacks\n */\nconst checkItemAccess = async ({\n item,\n permissions,\n req,\n}: {\n item: MCPItem\n permissions?: SanitizedPermissions\n req: PayloadRequest\n}): Promise<boolean> => {\n switch (item.type) {\n case 'collectionTool':\n return (\n !item.tool.access ||\n (await item.tool.access({ slug: item.collectionSlug, permissions, req }))\n )\n case 'globalTool':\n return (\n !item.tool.access || (await item.tool.access({ slug: item.globalSlug, permissions, req }))\n )\n case 'prompt':\n return !item.prompt.access || (await item.prompt.access({ permissions, req }))\n case 'resource':\n return !item.resource.access || (await item.resource.access({ permissions, req }))\n case 'tool':\n return !item.tool.access || (await item.tool.access({ permissions, req }))\n }\n}\n"],"names":["executeAuthStrategies","getAccessResults","UnauthorizedError","extractBearerToken","getPluginConfig","authenticateLoginToken","getAuthorizedMCP","isHTTP","overrideAccess","req","pluginConfig","config","payload","isChallengedWhenSignedOut","Boolean","oauth","overrideGetAuthorizedMCP","headers","Headers","hasAuthorization","has","set","responseHeaders","user","canSetHeaders","bearerToken","type","issueToken","token","authenticate","t","items","filterMCPItems","authorizedItems","permissions","item","checkItemAccess","push","tool","access","slug","collectionSlug","globalSlug","prompt","resource"],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/endpoint/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAA;AAe7D,eAAO,MAAM,WAAW,EAAE,cAkFzB,CAAA"}
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { createMcpHandler, isLegacyRequest, readRequestBody, WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/server';
|
|
2
|
+
import { APIError } from 'payload';
|
|
3
|
+
import { buildMcpServer } from '../mcp/buildMcpServer.js';
|
|
4
|
+
import { getPluginConfig } from '../utils/getPluginConfig.js';
|
|
5
|
+
import { getAuthorizedMCP } from './access.js';
|
|
6
|
+
import { getMCPResource, oauthChallenge } from './oauth.js';
|
|
7
|
+
export const mcpEndpoint = async (req)=>{
|
|
8
|
+
if (!req.url) {
|
|
9
|
+
throw new APIError('Missing request URL', 400);
|
|
10
|
+
}
|
|
11
|
+
req.payloadAPI = 'MCP';
|
|
12
|
+
// Lets auth strategies check that an OAuth access token was issued for this MCP server
|
|
13
|
+
req.context.mcp = {
|
|
14
|
+
resource: getMCPResource({
|
|
15
|
+
req
|
|
16
|
+
})
|
|
17
|
+
};
|
|
18
|
+
const pluginConfig = getPluginConfig({
|
|
19
|
+
config: req.payload.config
|
|
20
|
+
});
|
|
21
|
+
const overrideAccessParam = new URL(req.url).searchParams.get('overrideAccess');
|
|
22
|
+
if (overrideAccessParam !== null && process.env.NODE_ENV !== 'development') {
|
|
23
|
+
throw new APIError('MCP overrideAccess is only available in development.', 400);
|
|
24
|
+
}
|
|
25
|
+
let overrideAccess = false;
|
|
26
|
+
if (overrideAccessParam === 'true') {
|
|
27
|
+
overrideAccess = true;
|
|
28
|
+
} else if (overrideAccessParam !== null && overrideAccessParam !== 'false') {
|
|
29
|
+
throw new APIError('MCP overrideAccess must be "true" or "false".', 400);
|
|
30
|
+
}
|
|
31
|
+
const authorizedMCP = await getAuthorizedMCP({
|
|
32
|
+
isHTTP: true,
|
|
33
|
+
overrideAccess,
|
|
34
|
+
req
|
|
35
|
+
});
|
|
36
|
+
// Clients like Codex send a GET first to find out where to sign in, so this comes before the
|
|
37
|
+
// GET check
|
|
38
|
+
if (pluginConfig.oauth && !req.user) {
|
|
39
|
+
return oauthChallenge({
|
|
40
|
+
req
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
// Streamable HTTP's optional server-to-client stream. We don't offer one, so answer 405 per
|
|
44
|
+
// spec, and clients skip it
|
|
45
|
+
if (req.method === 'GET') {
|
|
46
|
+
return new Response(null, {
|
|
47
|
+
headers: {
|
|
48
|
+
Allow: 'POST'
|
|
49
|
+
},
|
|
50
|
+
status: 405
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
const maxRequestBodySize = pluginConfig.mcp?.maxRequestBodySize;
|
|
54
|
+
// Payload augments the original web-standard Request in place.
|
|
55
|
+
const mcpRequest = req;
|
|
56
|
+
const parsedBody = await parseRequestBody({
|
|
57
|
+
maxRequestBodySize,
|
|
58
|
+
request: mcpRequest
|
|
59
|
+
});
|
|
60
|
+
// Keep the old JSON-only, stateless behavior because the SDK's 2025 fallback uses SSE.
|
|
61
|
+
if (await isLegacyRequest(mcpRequest, parsedBody, {
|
|
62
|
+
maxRequestBodySize
|
|
63
|
+
})) {
|
|
64
|
+
const server = buildMcpServer({
|
|
65
|
+
authorizedMCP,
|
|
66
|
+
pluginConfig,
|
|
67
|
+
req
|
|
68
|
+
});
|
|
69
|
+
const transport = new WebStandardStreamableHTTPServerTransport({
|
|
70
|
+
enableJsonResponse: true,
|
|
71
|
+
maxRequestBodySize,
|
|
72
|
+
sessionIdGenerator: undefined
|
|
73
|
+
});
|
|
74
|
+
transport.onerror = (err)=>{
|
|
75
|
+
req.payload.logger.error({
|
|
76
|
+
err,
|
|
77
|
+
msg: 'Error serving legacy MCP request'
|
|
78
|
+
});
|
|
79
|
+
};
|
|
80
|
+
try {
|
|
81
|
+
await server.connect(transport);
|
|
82
|
+
return await transport.handleRequest(mcpRequest, {
|
|
83
|
+
parsedBody
|
|
84
|
+
});
|
|
85
|
+
} finally{
|
|
86
|
+
await server.close().catch((err)=>{
|
|
87
|
+
req.payload.logger.error({
|
|
88
|
+
err,
|
|
89
|
+
msg: 'Error closing MCP server'
|
|
90
|
+
});
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
const handler = createMcpHandler(()=>buildMcpServer({
|
|
95
|
+
authorizedMCP,
|
|
96
|
+
pluginConfig,
|
|
97
|
+
req
|
|
98
|
+
}), {
|
|
99
|
+
legacy: 'reject',
|
|
100
|
+
maxRequestBodySize,
|
|
101
|
+
// SDK subscriptions always use SSE, so disable them to keep every response JSON-only.
|
|
102
|
+
maxSubscriptions: 0,
|
|
103
|
+
onerror: (err)=>{
|
|
104
|
+
req.payload.logger.error({
|
|
105
|
+
err,
|
|
106
|
+
msg: 'Error serving modern MCP request'
|
|
107
|
+
});
|
|
108
|
+
},
|
|
109
|
+
responseMode: 'json'
|
|
110
|
+
});
|
|
111
|
+
try {
|
|
112
|
+
return await handler.fetch(mcpRequest, {
|
|
113
|
+
parsedBody
|
|
114
|
+
});
|
|
115
|
+
} finally{
|
|
116
|
+
await handler.close().catch((err)=>{
|
|
117
|
+
req.payload.logger.error({
|
|
118
|
+
err,
|
|
119
|
+
msg: 'Error closing modern MCP handler'
|
|
120
|
+
});
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
};
|
|
124
|
+
/**
|
|
125
|
+
* Parses a POST body once so the era check and the SDK handler can share it. The SDK
|
|
126
|
+
* skips its size limit for a pre-parsed body, so this reads with the same limit. It reads
|
|
127
|
+
* a clone and returns `undefined` for any body the SDK should reject (too large, unreadable,
|
|
128
|
+
* or not JSON), leaving the original request for the SDK to read and answer.
|
|
129
|
+
*/ const parseRequestBody = async ({ maxRequestBodySize, request })=>{
|
|
130
|
+
if (request.method.toUpperCase() !== 'POST') {
|
|
131
|
+
return undefined;
|
|
132
|
+
}
|
|
133
|
+
try {
|
|
134
|
+
const body = await readRequestBody(request.clone(), maxRequestBodySize);
|
|
135
|
+
return body.tooLarge ? undefined : JSON.parse(body.text);
|
|
136
|
+
} catch {
|
|
137
|
+
return undefined;
|
|
138
|
+
}
|
|
139
|
+
};
|
|
140
|
+
|
|
141
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/endpoint/index.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\n\nimport {\n createMcpHandler,\n isLegacyRequest,\n readRequestBody,\n WebStandardStreamableHTTPServerTransport,\n} from '@modelcontextprotocol/server'\nimport { APIError } from 'payload'\n\nimport { buildMcpServer } from '../mcp/buildMcpServer.js'\nimport { getPluginConfig } from '../utils/getPluginConfig.js'\nimport { getAuthorizedMCP } from './access.js'\nimport { getMCPResource, oauthChallenge } from './oauth.js'\n\nexport const mcpEndpoint: PayloadHandler = async (req) => {\n if (!req.url) {\n throw new APIError('Missing request URL', 400)\n }\n\n req.payloadAPI = 'MCP' as const\n // Lets auth strategies check that an OAuth access token was issued for this MCP server\n req.context.mcp = { resource: getMCPResource({ req }) }\n\n const pluginConfig = getPluginConfig({ config: req.payload.config })\n const overrideAccessParam = new URL(req.url).searchParams.get('overrideAccess')\n\n if (overrideAccessParam !== null && process.env.NODE_ENV !== 'development') {\n throw new APIError('MCP overrideAccess is only available in development.', 400)\n }\n\n let overrideAccess = false\n if (overrideAccessParam === 'true') {\n overrideAccess = true\n } else if (overrideAccessParam !== null && overrideAccessParam !== 'false') {\n throw new APIError('MCP overrideAccess must be \"true\" or \"false\".', 400)\n }\n\n const authorizedMCP = await getAuthorizedMCP({ isHTTP: true, overrideAccess, req })\n\n // Clients like Codex send a GET first to find out where to sign in, so this comes before the\n // GET check\n if (pluginConfig.oauth && !req.user) {\n return oauthChallenge({ req })\n }\n\n // Streamable HTTP's optional server-to-client stream. We don't offer one, so answer 405 per\n // spec, and clients skip it\n if (req.method === 'GET') {\n return new Response(null, { headers: { Allow: 'POST' }, status: 405 })\n }\n\n const maxRequestBodySize = pluginConfig.mcp?.maxRequestBodySize\n // Payload augments the original web-standard Request in place.\n const mcpRequest = req as PayloadRequest & Request\n const parsedBody = await parseRequestBody({ maxRequestBodySize, request: mcpRequest })\n\n // Keep the old JSON-only, stateless behavior because the SDK's 2025 fallback uses SSE.\n if (await isLegacyRequest(mcpRequest, parsedBody, { maxRequestBodySize })) {\n const server = buildMcpServer({ authorizedMCP, pluginConfig, req })\n const transport = new WebStandardStreamableHTTPServerTransport({\n enableJsonResponse: true,\n maxRequestBodySize,\n sessionIdGenerator: undefined, // stateless mode\n })\n transport.onerror = (err) => {\n req.payload.logger.error({ err, msg: 'Error serving legacy MCP request' })\n }\n\n try {\n await server.connect(transport)\n return await transport.handleRequest(mcpRequest, { parsedBody })\n } finally {\n await server.close().catch((err) => {\n req.payload.logger.error({ err, msg: 'Error closing MCP server' })\n })\n }\n }\n\n const handler = createMcpHandler(() => buildMcpServer({ authorizedMCP, pluginConfig, req }), {\n legacy: 'reject',\n maxRequestBodySize,\n // SDK subscriptions always use SSE, so disable them to keep every response JSON-only.\n maxSubscriptions: 0,\n onerror: (err) => {\n req.payload.logger.error({ err, msg: 'Error serving modern MCP request' })\n },\n responseMode: 'json',\n })\n\n try {\n return await handler.fetch(mcpRequest, { parsedBody })\n } finally {\n await handler.close().catch((err) => {\n req.payload.logger.error({ err, msg: 'Error closing modern MCP handler' })\n })\n }\n}\n\n/**\n * Parses a POST body once so the era check and the SDK handler can share it. The SDK\n * skips its size limit for a pre-parsed body, so this reads with the same limit. It reads\n * a clone and returns `undefined` for any body the SDK should reject (too large, unreadable,\n * or not JSON), leaving the original request for the SDK to read and answer.\n */\nconst parseRequestBody = async ({\n maxRequestBodySize,\n request,\n}: {\n maxRequestBodySize?: number\n request: Request\n}): Promise<unknown> => {\n if (request.method.toUpperCase() !== 'POST') {\n return undefined\n }\n\n try {\n const body = await readRequestBody(request.clone(), maxRequestBodySize)\n return body.tooLarge ? undefined : JSON.parse(body.text)\n } catch {\n return undefined\n }\n}\n"],"names":["createMcpHandler","isLegacyRequest","readRequestBody","WebStandardStreamableHTTPServerTransport","APIError","buildMcpServer","getPluginConfig","getAuthorizedMCP","getMCPResource","oauthChallenge","mcpEndpoint","req","url","payloadAPI","context","mcp","resource","pluginConfig","config","payload","overrideAccessParam","URL","searchParams","get","process","env","NODE_ENV","overrideAccess","authorizedMCP","isHTTP","oauth","user","method","Response","headers","Allow","status","maxRequestBodySize","mcpRequest","parsedBody","parseRequestBody","request","server","transport","enableJsonResponse","sessionIdGenerator","undefined","onerror","err","logger","error","msg","connect","handleRequest","close","catch","handler","legacy","maxSubscriptions","responseMode","fetch","toUpperCase","body","clone","tooLarge","JSON","parse","text"],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { PayloadHandler, PayloadRequest, SanitizedConfig } from 'payload';
|
|
2
|
+
/**
|
|
3
|
+
* Serves the OAuth protected resource metadata (RFC 9728) at `/api/mcp/oauth-protected-resource`.
|
|
4
|
+
* The OAuth challenge links here, so MCP clients find the authorization server without setup.
|
|
5
|
+
*/
|
|
6
|
+
export declare const oauthProtectedResourceEndpoint: PayloadHandler;
|
|
7
|
+
/**
|
|
8
|
+
* Serves the same metadata for clients that ignore the challenge's link and only look at
|
|
9
|
+
* `/.well-known/oauth-protected-resource`. Mount it at the site root, e.g. in Next.js at
|
|
10
|
+
* `app/.well-known/oauth-protected-resource/[[...path]]/route.ts`:
|
|
11
|
+
*
|
|
12
|
+
* ```ts
|
|
13
|
+
* import config from '@payload-config'
|
|
14
|
+
* import { oauthProtectedResourceHandler } from '@payloadcms/plugin-mcp'
|
|
15
|
+
*
|
|
16
|
+
* export const GET = oauthProtectedResourceHandler({ config })
|
|
17
|
+
* ```
|
|
18
|
+
*/
|
|
19
|
+
export declare const oauthProtectedResourceHandler: ({ config }: {
|
|
20
|
+
config: Promise<SanitizedConfig> | SanitizedConfig;
|
|
21
|
+
}) => (request: Request) => Promise<Response>;
|
|
22
|
+
/**
|
|
23
|
+
* Answers an unauthenticated MCP request with a challenge linking to the protected resource
|
|
24
|
+
* metadata, which starts the client's OAuth flow.
|
|
25
|
+
*/
|
|
26
|
+
export declare const oauthChallenge: ({ req }: {
|
|
27
|
+
req: PayloadRequest;
|
|
28
|
+
}) => Response;
|
|
29
|
+
/**
|
|
30
|
+
* The MCP endpoint's address, as advertised in the metadata's `resource`. The metadata link and
|
|
31
|
+
* the built-in authorization server's issuer are based on it. Clients send it when they sign in,
|
|
32
|
+
* and authorization servers that support it put it in the access token's audience.
|
|
33
|
+
*/
|
|
34
|
+
export declare const getMCPResource: ({ req }: {
|
|
35
|
+
req: PayloadRequest;
|
|
36
|
+
}) => string;
|
|
37
|
+
//# sourceMappingURL=oauth.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/endpoint/oauth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAY9E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,cAAsD,CAAA;AAEnG;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,eAC3B;IAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAA;CAAE,eACnD,OAAO,KAAG,OAAO,CAAC,QAAQ,CAGtC,CAAA;AAEN;;;GAGG;AACH,eAAO,MAAM,cAAc,YAAa;IAAE,GAAG,EAAE,cAAc,CAAA;CAAE,KAAG,QAcjE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,YAAa;IAAE,GAAG,EAAE,cAAc,CAAA;CAAE,KAAG,MAgBjE,CAAA"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { bearerAuthChallengeResponse, OAuthError, OAuthErrorCode } from '@modelcontextprotocol/server';
|
|
2
|
+
import { createPayloadRequest, getPayload } from 'payload';
|
|
3
|
+
import { formatAdminURL, stripTrailingSlash } from 'payload/shared';
|
|
4
|
+
import { getPluginConfig } from '../utils/getPluginConfig.js';
|
|
5
|
+
/**
|
|
6
|
+
* Serves the OAuth protected resource metadata (RFC 9728) at `/api/mcp/oauth-protected-resource`.
|
|
7
|
+
* The OAuth challenge links here, so MCP clients find the authorization server without setup.
|
|
8
|
+
*/ export const oauthProtectedResourceEndpoint = (req)=>getMetadataResponse({
|
|
9
|
+
req
|
|
10
|
+
});
|
|
11
|
+
/**
|
|
12
|
+
* Serves the same metadata for clients that ignore the challenge's link and only look at
|
|
13
|
+
* `/.well-known/oauth-protected-resource`. Mount it at the site root, e.g. in Next.js at
|
|
14
|
+
* `app/.well-known/oauth-protected-resource/[[...path]]/route.ts`:
|
|
15
|
+
*
|
|
16
|
+
* ```ts
|
|
17
|
+
* import config from '@payload-config'
|
|
18
|
+
* import { oauthProtectedResourceHandler } from '@payloadcms/plugin-mcp'
|
|
19
|
+
*
|
|
20
|
+
* export const GET = oauthProtectedResourceHandler({ config })
|
|
21
|
+
* ```
|
|
22
|
+
*/ export const oauthProtectedResourceHandler = ({ config })=>async (request)=>getMetadataResponse({
|
|
23
|
+
req: await createPayloadRequest({
|
|
24
|
+
payload: await getPayload({
|
|
25
|
+
config
|
|
26
|
+
}),
|
|
27
|
+
req: request
|
|
28
|
+
})
|
|
29
|
+
});
|
|
30
|
+
/**
|
|
31
|
+
* Answers an unauthenticated MCP request with a challenge linking to the protected resource
|
|
32
|
+
* metadata, which starts the client's OAuth flow.
|
|
33
|
+
*/ export const oauthChallenge = ({ req })=>{
|
|
34
|
+
const { oauth } = getPluginConfig({
|
|
35
|
+
config: req.payload.config
|
|
36
|
+
});
|
|
37
|
+
const response = bearerAuthChallengeResponse(new OAuthError(OAuthErrorCode.InvalidToken, req.t('error:unauthorized')), {
|
|
38
|
+
requiredScopes: oauth?.type === 'external' ? oauth.scopes : undefined,
|
|
39
|
+
resourceMetadataUrl: `${getMCPResource({
|
|
40
|
+
req
|
|
41
|
+
})}/oauth-protected-resource`
|
|
42
|
+
});
|
|
43
|
+
// Lets browser-based MCP clients read the challenge, when Payload's `cors` setting allows them
|
|
44
|
+
response.headers.set('Access-Control-Expose-Headers', 'WWW-Authenticate');
|
|
45
|
+
return response;
|
|
46
|
+
};
|
|
47
|
+
/**
|
|
48
|
+
* The MCP endpoint's address, as advertised in the metadata's `resource`. The metadata link and
|
|
49
|
+
* the built-in authorization server's issuer are based on it. Clients send it when they sign in,
|
|
50
|
+
* and authorization servers that support it put it in the access token's audience.
|
|
51
|
+
*/ export const getMCPResource = ({ req })=>{
|
|
52
|
+
const { config } = req.payload;
|
|
53
|
+
const resource = getPluginConfig({
|
|
54
|
+
config
|
|
55
|
+
}).oauth?.resource;
|
|
56
|
+
if (typeof resource === 'function') {
|
|
57
|
+
return resource({
|
|
58
|
+
req
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
if (resource) {
|
|
62
|
+
return resource;
|
|
63
|
+
}
|
|
64
|
+
// Without the slash Next.js's `trailingSlash` would add, since the metadata link appends to it
|
|
65
|
+
const path = stripTrailingSlash(formatAdminURL({
|
|
66
|
+
apiRoute: config.routes.api,
|
|
67
|
+
path: '/mcp'
|
|
68
|
+
}));
|
|
69
|
+
return new URL(path, config.serverURL || req.url).href;
|
|
70
|
+
};
|
|
71
|
+
const getMetadataResponse = async ({ req })=>{
|
|
72
|
+
const { config } = req.payload;
|
|
73
|
+
const { oauth } = getPluginConfig({
|
|
74
|
+
config
|
|
75
|
+
});
|
|
76
|
+
if (!oauth) {
|
|
77
|
+
return new Response(null, {
|
|
78
|
+
status: 404
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
const resource = getMCPResource({
|
|
82
|
+
req
|
|
83
|
+
});
|
|
84
|
+
return Response.json({
|
|
85
|
+
authorization_servers: oauth.type === 'builtin' ? [
|
|
86
|
+
`${resource}/oauth`
|
|
87
|
+
] : typeof oauth.authorizationServers === 'function' ? await oauth.authorizationServers({
|
|
88
|
+
req
|
|
89
|
+
}) : oauth.authorizationServers,
|
|
90
|
+
bearer_methods_supported: [
|
|
91
|
+
'header'
|
|
92
|
+
],
|
|
93
|
+
resource,
|
|
94
|
+
scopes_supported: oauth.type === 'external' ? oauth.scopes : undefined
|
|
95
|
+
}, // Public document, readable by browser-based MCP clients on any origin. Not cached, since its
|
|
96
|
+
// URLs can depend on the request.
|
|
97
|
+
{
|
|
98
|
+
headers: {
|
|
99
|
+
'Access-Control-Allow-Origin': '*',
|
|
100
|
+
'Cache-Control': 'no-store'
|
|
101
|
+
}
|
|
102
|
+
});
|
|
103
|
+
};
|
|
104
|
+
|
|
105
|
+
//# sourceMappingURL=oauth.js.map
|