@payloadcms/plugin-mcp 4.0.0-internal.1f9ae9a → 4.0.0-internal.2fddfc0

package/src/components/AccessField/index.client.tsx

@@ -1,344 +0,0 @@
-'use client'
-
-import type { JSONFieldClientProps } from 'payload'
-
-import { CheckboxInput, Collapsible, useField } from '@payloadcms/ui'
-import React from 'react'
-
-import type { ClientMCPPluginConfig, MCPAPIKeysDocAccessTree } from '../../types.js'
-
-import './index.css'
-
-const baseClass = 'mcp-access-field'
-
-type ClientItem = ClientMCPPluginConfig['items'][number]
-type ScopeKey = 'collections' | 'globals'
-type FlatKey = 'prompts' | 'resources' | 'tools'
-
-type Props = {
-  pluginConfig: ClientMCPPluginConfig
-} & JSONFieldClientProps
-
-/** Drop a key from an object and return a new object — or `undefined` if it'd be empty. */
-const without = <T extends Record<string, unknown>>(
-  obj: T | undefined,
-  key: string,
-): T | undefined => {
-  if (!obj || !(key in obj)) {
-    return obj
-  }
-  const { [key]: _omitted, ...rest } = obj
-  return Object.keys(rest).length === 0 ? undefined : (rest as T)
-}
-
-const setKey = <T extends Record<string, unknown>>(
-  obj: T | undefined,
-  key: string,
-  value: unknown,
-): T => ({ ...(obj ?? {}), [key]: value }) as T
-
-export const AccessField: React.FC<Props> = ({ path, pluginConfig }) => {
-  const { setValue, value } = useField<MCPAPIKeysDocAccessTree>({ path })
-  const access = value ?? {}
-
-  // Bucket items for rendering. (Bucketing is cheap and runs once per render;
-  // memoizing would mean managing inputs/refs for marginal benefit.)
-  const collectionsBySlug: Record<string, ClientItem[]> = {}
-  const globalsBySlug: Record<string, ClientItem[]> = {}
-  const tools: ClientItem[] = []
-  const prompts: ClientItem[] = []
-  const resources: ClientItem[] = []
-  for (const item of pluginConfig.items) {
-    switch (item.type) {
-      case 'collectionTool':
-        ;(collectionsBySlug[item.collectionSlug!] ??= []).push(item)
-        break
-      case 'globalTool':
-        ;(globalsBySlug[item.globalSlug!] ??= []).push(item)
-        break
-      case 'prompt':
-        prompts.push(item)
-        break
-      case 'resource':
-        resources.push(item)
-        break
-      case 'tool':
-        tools.push(item)
-        break
-    }
-  }
-
-  const isScopedAllowed = (scope: ScopeKey, slug: string, key: string): boolean =>
-    access[scope]?.[slug]?.[key] !== false
-
-  const isFlatAllowed = (scope: FlatKey, key: string): boolean => access[scope]?.[key] !== false
-
-  const toggleScoped = (scope: ScopeKey, slug: string, key: string, allow: boolean) => {
-    if (allow) {
-      const slugBucket = without(access[scope]?.[slug], key)
-      const scopeBucket = slugBucket
-        ? setKey(access[scope], slug, slugBucket)
-        : without(access[scope], slug)
-      setValue(scopeBucket ? setKey(access, scope, scopeBucket) : (without(access, scope) ?? {}))
-    } else {
-      setValue(
-        setKey(
-          access,
-          scope,
-          setKey(access[scope], slug, setKey(access[scope]?.[slug], key, false)),
-        ),
-      )
-    }
-  }
-
-  const toggleFlat = (scope: FlatKey, key: string, allow: boolean) => {
-    if (allow) {
-      const bucket = without(access[scope], key)
-      setValue(bucket ? setKey(access, scope, bucket) : (without(access, scope) ?? {}))
-    } else {
-      setValue(setKey(access, scope, setKey(access[scope], key, false)))
-    }
-  }
-
-  const setAllScoped = (scope: ScopeKey, slug: string, leaves: ClientItem[], allow: boolean) => {
-    if (allow) {
-      const scopeBucket = without(access[scope], slug)
-      setValue(scopeBucket ? setKey(access, scope, scopeBucket) : (without(access, scope) ?? {}))
-    } else {
-      const slugBucket = leaves.reduce<Record<string, boolean>>(
-        (acc, leaf) => ({ ...acc, [leaf.key]: false }),
-        {},
-      )
-      setValue(setKey(access, scope, setKey(access[scope], slug, slugBucket)))
-    }
-  }
-
-  const setAllFlat = (scope: FlatKey, leaves: ClientItem[], allow: boolean) => {
-    if (allow) {
-      setValue(without(access, scope) ?? {})
-    } else {
-      const bucket = leaves.reduce<Record<string, boolean>>(
-        (acc, leaf) => ({ ...acc, [leaf.key]: false }),
-        {},
-      )
-      setValue(setKey(access, scope, bucket))
-    }
-  }
-
-  const collectionSlugs = Object.keys(collectionsBySlug)
-  const globalSlugs = Object.keys(globalsBySlug)
-
-  return (
-    <div className={baseClass}>
-      {collectionSlugs.length > 0 && (
-        <section className={`${baseClass}__section`}>
-          <header className={`${baseClass}__section-header`}>
-            {/* TODO: needs i18n once design is finalized */}
-            <h4>Collection-level permissions</h4>
-            {/* TODO: needs i18n once design is finalized */}
-            <p>Allow MCP clients to perform the following actions within these collections:</p>
-          </header>
-          {collectionSlugs.map((slug) => {
-            const leaves = collectionsBySlug[slug]!
-            return (
-              <Collapsible
-                actions={
-                  <GroupActions
-                    onSetAll={(allow) => setAllScoped('collections', slug, leaves, allow)}
-                  />
-                }
-                className={`${baseClass}__group`}
-                header={<span className={`${baseClass}__group-label`}>{titleCase(slug)}</span>}
-                initCollapsed
-                key={`collection-${slug}`}
-              >
-                <ul className={`${baseClass}__list`}>
-                  {leaves.map((leaf) => (
-                    <li key={leaf.key}>
-                      <CheckboxInput
-                        checked={isScopedAllowed('collections', slug, leaf.key)}
-                        id={`${path}.collections.${slug}.${leaf.key}`}
-                        label={leaf.label}
-                        onToggle={(e) =>
-                          toggleScoped('collections', slug, leaf.key, e.target.checked)
-                        }
-                        tooltip={leaf.description}
-                      />
-                    </li>
-                  ))}
-                </ul>
-              </Collapsible>
-            )
-          })}
-        </section>
-      )}
-
-      {globalSlugs.length > 0 && (
-        <section className={`${baseClass}__section`}>
-          <header className={`${baseClass}__section-header`}>
-            {/* TODO: needs i18n once design is finalized */}
-            <h4>Global-level permissions</h4>
-            {/* TODO: needs i18n once design is finalized */}
-            <p>Allow MCP clients to perform the following actions on these globals:</p>
-          </header>
-          {globalSlugs.map((slug) => {
-            const leaves = globalsBySlug[slug]!
-            return (
-              <Collapsible
-                actions={
-                  <GroupActions
-                    onSetAll={(allow) => setAllScoped('globals', slug, leaves, allow)}
-                  />
-                }
-                className={`${baseClass}__group`}
-                header={<span className={`${baseClass}__group-label`}>{titleCase(slug)}</span>}
-                initCollapsed
-                key={`global-${slug}`}
-              >
-                <ul className={`${baseClass}__list`}>
-                  {leaves.map((leaf) => (
-                    <li key={leaf.key}>
-                      <CheckboxInput
-                        checked={isScopedAllowed('globals', slug, leaf.key)}
-                        id={`${path}.globals.${slug}.${leaf.key}`}
-                        label={leaf.label}
-                        onToggle={(e) => toggleScoped('globals', slug, leaf.key, e.target.checked)}
-                        tooltip={leaf.description}
-                      />
-                    </li>
-                  ))}
-                </ul>
-              </Collapsible>
-            )
-          })}
-        </section>
-      )}
-
-      {(tools.length > 0 || prompts.length > 0 || resources.length > 0) && (
-        <section className={`${baseClass}__section`}>
-          <header className={`${baseClass}__section-header`}>
-            {/* TODO: needs i18n once design is finalized */}
-            <h4>Project-level permissions</h4>
-            {/* TODO: needs i18n once design is finalized */}
-            <p>Cross-cutting tools, prompts, and resources not scoped to a single collection.</p>
-          </header>
-          {tools.length > 0 && (
-            <Collapsible
-              actions={<GroupActions onSetAll={(allow) => setAllFlat('tools', tools, allow)} />}
-              className={`${baseClass}__group`}
-              header={
-                /* TODO: needs i18n once design is finalized */
-                <span className={`${baseClass}__group-label`}>Tools</span>
-              }
-              initCollapsed
-            >
-              <ul className={`${baseClass}__list`}>
-                {tools.map((leaf) => (
-                  <li key={leaf.key}>
-                    <CheckboxInput
-                      checked={isFlatAllowed('tools', leaf.key)}
-                      id={`${path}.tools.${leaf.key}`}
-                      label={leaf.label}
-                      onToggle={(e) => toggleFlat('tools', leaf.key, e.target.checked)}
-                      tooltip={leaf.description}
-                    />
-                  </li>
-                ))}
-              </ul>
-            </Collapsible>
-          )}
-          {prompts.length > 0 && (
-            <Collapsible
-              actions={<GroupActions onSetAll={(allow) => setAllFlat('prompts', prompts, allow)} />}
-              className={`${baseClass}__group`}
-              header={
-                /* TODO: needs i18n once design is finalized */
-                <span className={`${baseClass}__group-label`}>Prompts</span>
-              }
-              initCollapsed
-            >
-              <ul className={`${baseClass}__list`}>
-                {prompts.map((leaf) => (
-                  <li key={leaf.key}>
-                    <CheckboxInput
-                      checked={isFlatAllowed('prompts', leaf.key)}
-                      id={`${path}.prompts.${leaf.key}`}
-                      label={leaf.label}
-                      onToggle={(e) => toggleFlat('prompts', leaf.key, e.target.checked)}
-                      tooltip={leaf.description}
-                    />
-                  </li>
-                ))}
-              </ul>
-            </Collapsible>
-          )}
-          {resources.length > 0 && (
-            <Collapsible
-              actions={
-                <GroupActions onSetAll={(allow) => setAllFlat('resources', resources, allow)} />
-              }
-              className={`${baseClass}__group`}
-              header={
-                /* TODO: needs i18n once design is finalized */
-                <span className={`${baseClass}__group-label`}>Resources</span>
-              }
-              initCollapsed
-            >
-              <ul className={`${baseClass}__list`}>
-                {resources.map((leaf) => (
-                  <li key={leaf.key}>
-                    <CheckboxInput
-                      checked={isFlatAllowed('resources', leaf.key)}
-                      id={`${path}.resources.${leaf.key}`}
-                      label={leaf.label}
-                      onToggle={(e) => toggleFlat('resources', leaf.key, e.target.checked)}
-                      tooltip={leaf.description}
-                    />
-                  </li>
-                ))}
-              </ul>
-            </Collapsible>
-          )}
-        </section>
-      )}
-    </div>
-  )
-}
-
-const GroupActions: React.FC<{ onSetAll: (allow: boolean) => void }> = ({ onSetAll }) => (
-  // TODO: button labels + aria-labels need i18n once design is finalized
-  <div className={`${baseClass}__group-actions`}>
-    <button
-      aria-label="Select all"
-      className={`${baseClass}__action`}
-      onClick={(e) => {
-        e.stopPropagation()
-        onSetAll(true)
-      }}
-      title="Select all"
-      type="button"
-    >
-      all
-    </button>
-    <span aria-hidden className={`${baseClass}__action-sep`}>
-      /
-    </span>
-    <button
-      aria-label="Clear all"
-      className={`${baseClass}__action`}
-      onClick={(e) => {
-        e.stopPropagation()
-        onSetAll(false)
-      }}
-      title="Clear all"
-      type="button"
-    >
-      none
-    </button>
-  </div>
-)
-
-const titleCase = (slug: string): string =>
-  slug.replace(/(^|[-_])(.)/g, (_, sep: string, ch: string) =>
-    sep ? ` ${ch.toUpperCase()}` : ch.toUpperCase(),
-  )

package/src/components/AccessField/index.css

@@ -1,93 +0,0 @@
-@layer payload-default {
-  .mcp-access-field {
-    display: flex;
-    flex-direction: column;
-    gap: var(--base);
-  }
-
-  .mcp-access-field__section {
-    display: flex;
-    flex-direction: column;
-    gap: calc(var(--base) / 2);
-    padding-bottom: var(--base);
-    /* Full-bleed separator: extend past the sidebar's horizontal gutter so the
-       border-block-end spans the entire sidebar width. */
-    margin-inline-start: calc(-1 * var(--sidebar-gutter-h-left, var(--gutter-h)));
-    margin-inline-end: calc(-1 * var(--sidebar-gutter-h-right, var(--gutter-h)));
-    padding-inline-start: var(--sidebar-gutter-h-left, var(--gutter-h));
-    padding-inline-end: var(--sidebar-gutter-h-right, var(--gutter-h));
-    border-block-end: 1px solid var(--theme-elevation-100);
-  }
-
-  .mcp-access-field__section:last-child {
-    border-block-end: none;
-  }
-
-  .mcp-access-field__section-header {
-    display: flex;
-    flex-direction: column;
-  }
-
-  .mcp-access-field__section-header h4 {
-    margin: 0;
-    color: var(--color-text);
-    font-family: var(--text-heading-small-font-family);
-    font-size: var(--text-heading-small-font-size);
-    font-weight: var(--text-heading-small-font-weight);
-    line-height: var(--text-heading-small-line-height);
-    letter-spacing: var(--text-heading-small-letter-spacing);
-  }
-
-  .mcp-access-field__section-header p {
-    margin: 0;
-    color: var(--color-text-secondary);
-    font-family: var(--text-body-medium-font-family);
-    font-size: var(--text-body-medium-font-size);
-    font-weight: var(--text-body-medium-font-weight);
-    line-height: var(--text-body-medium-line-height);
-    letter-spacing: var(--text-body-medium-letter-spacing);
-  }
-
-  .mcp-access-field__group {
-    margin-block-end: calc(var(--base) / 2);
-  }
-
-  .mcp-access-field__group-label {
-    font-weight: 600;
-  }
-
-  .mcp-access-field__group-actions {
-    display: flex;
-    align-items: center;
-    gap: calc(var(--base) / 6);
-  }
-
-  .mcp-access-field__action {
-    appearance: none;
-    background: none;
-    border: none;
-    color: var(--theme-elevation-500);
-    cursor: pointer;
-    font-size: 0.75rem;
-    padding: 0;
-  }
-
-  .mcp-access-field__action:hover {
-    color: var(--theme-text);
-    text-decoration: underline;
-  }
-
-  .mcp-access-field__action-sep {
-    color: var(--theme-elevation-300);
-    font-size: 0.75rem;
-  }
-
-  .mcp-access-field__list {
-    list-style: none;
-    margin: 0;
-    padding: 0;
-    display: flex;
-    flex-direction: column;
-    gap: calc(var(--base) / 3);
-  }
-}

package/src/utils/schemaConversion/prepareCollectionSchema.ts

@@ -1,39 +0,0 @@
-import type { JsonSchemaType } from '../../types.js'
-
-import { sanitizeJsonSchema } from './sanitizeJsonSchema.js'
-import { simplifyRelationshipFields } from './simplifyRelationshipFields.js'
-import { transformPointFieldsForMCP } from './transformPointFields.js'
-
-/**
- * Fields Payload manages automatically — clients should never be required to provide
- * them. Stripped from `required` and `properties` so they don't appear in tool
- * inputs.
- */
-const PAYLOAD_MANAGED_FIELDS = new Set(['_status', 'createdAt', 'id', 'updatedAt'])
-
-/**
- * Sanitizes Payload's auto-generated collection JSON Schema so it can be safely
- * fed into the MCP server's `fromJsonSchema()` adapter (no zod intermediate step).
- */
-export const prepareCollectionSchema = (schema: JsonSchemaType): JsonSchemaType => {
-  // Clone to avoid mutating the original schema (used elsewhere for tool listing)
-  const schemaClone = JSON.parse(JSON.stringify(schema)) as JsonSchemaType
-
-  const sanitized = sanitizeJsonSchema(schemaClone)
-  const pointTransformed = transformPointFieldsForMCP(sanitized)
-  const simplified = simplifyRelationshipFields(pointTransformed)
-
-  if (simplified.properties) {
-    for (const field of PAYLOAD_MANAGED_FIELDS) {
-      delete simplified.properties[field]
-    }
-  }
-  if (Array.isArray(simplified.required)) {
-    simplified.required = simplified.required.filter((name) => !PAYLOAD_MANAGED_FIELDS.has(name))
-    if (simplified.required.length === 0) {
-      delete simplified.required
-    }
-  }
-
-  return simplified
-}

package/src/utils/schemaConversion/sanitizeJsonSchema.ts

@@ -1,62 +0,0 @@
-import type { JsonSchemaType } from '../../types.js'
-
-/**
- * Removes internal Payload properties (id, createdAt, updatedAt) from a
- * JSON Schema so they don't appear in the generated Zod validation schema.
- * Also strips `id` from the `required` array when present.
- *
- * Additionally normalizes nullable type arrays (e.g. `['array', 'null']` →
- * `'array'`) throughout the schema tree. Without this, `json-schema-to-zod`
- * emits a Zod union which the MCP SDK serialises back as `anyOf`, stripping
- * the concrete `type` from the output and breaking schema introspection.
- */
-export function sanitizeJsonSchema(schema: JsonSchemaType): JsonSchemaType {
-  delete schema?.properties?.id
-  delete schema?.properties?.createdAt
-  delete schema?.properties?.updatedAt
-
-  if (Array.isArray(schema.required)) {
-    schema.required = schema.required.filter((field) => field !== 'id')
-    if (schema.required.length === 0) {
-      delete schema.required
-    }
-  }
-
-  if (schema.properties && typeof schema.properties === 'object') {
-    for (const key of Object.keys(schema.properties)) {
-      const prop = schema.properties[key] as JsonSchemaType
-      if (!prop || typeof prop !== 'object') {
-        continue
-      }
-      normalizeNullableType(prop)
-      if (prop.properties) {
-        sanitizeJsonSchema(prop)
-      }
-      if (prop.items && typeof prop.items === 'object' && !Array.isArray(prop.items)) {
-        sanitizeJsonSchema(prop.items)
-      }
-    }
-  }
-
-  return schema
-}
-
-/**
- * Strips `'null'` from a `type` array only when the remaining type is a
- * complex structural type (`array` or `object`).
- *
- * Simple scalar types (`string`, `number`, `boolean`) are intentionally
- * preserved as `['string', 'null']` so that the MCP SDK serialises them as a
- * compact inline `type` array. Complex types however cause `zodToJsonSchema`
- * to emit `anyOf: [{ type: 'array', items: ... }, { type: 'null' }]`, which
- * has no top-level `type` property and breaks schema introspection by clients.
- */
-function normalizeNullableType(schema: JsonSchemaType): void {
-  if (!Array.isArray(schema.type)) {
-    return
-  }
-  const nonNullTypes = schema.type.filter((t) => t !== 'null')
-  if (nonNullTypes.length === 1 && (nonNullTypes[0] === 'array' || nonNullTypes[0] === 'object')) {
-    schema.type = nonNullTypes[0]
-  }
-}

package/src/utils/schemaConversion/simplifyRelationshipFields.ts

@@ -1,70 +0,0 @@
-import type { JsonSchemaType } from '../../types.js'
-
-/**
- * Recursively processes JSON schema properties to simplify relationship fields
- * and convert `oneOf` constructs into MCP-friendly schemas.
- *
- * For create/update validation we only need to accept IDs (string/number),
- * not populated objects. `$ref` options pointing to full entity definitions
- * are removed entirely from `oneOf` unions. When a single option remains the
- * `oneOf` is unwrapped; otherwise it is converted to `anyOf`.
- *
- * This matters because `json-schema-to-zod` converts `oneOf` into a strict
- * `z.any().superRefine(...)` validator whose base type is `z.any()`, causing
- * `zodToJsonSchema` to emit `{}` and losing all type information in the MCP
- * tool input schema. `anyOf` instead produces a clean `z.union([...])`.
- *
- * NOTE: This function must operate on a cloned schema to avoid mutating
- * the original JSON schema used for tool listing.
- */
-export function simplifyRelationshipFields(schema: JsonSchemaType): JsonSchemaType {
-  if (!schema || typeof schema !== 'object') {
-    return schema
-  }
-
-  const processed = { ...schema }
-
-  if (Array.isArray(processed.oneOf)) {
-    const hasRef = processed.oneOf.some(
-      (option) => option && typeof option === 'object' && '$ref' in option,
-    )
-
-    const recurse = (option: boolean | JsonSchemaType): boolean | JsonSchemaType =>
-      typeof option === 'object' ? simplifyRelationshipFields(option) : option
-
-    if (hasRef) {
-      const nonRefOptions = processed.oneOf
-        .filter((option) => !(option && typeof option === 'object' && '$ref' in option))
-        .map(recurse)
-
-      if (nonRefOptions.length === 1) {
-        const single = nonRefOptions[0]!
-        delete processed.oneOf
-        if (typeof single === 'object') {
-          Object.assign(processed, single)
-        }
-      } else if (nonRefOptions.length > 1) {
-        delete processed.oneOf
-        processed.anyOf = nonRefOptions
-      }
-    } else {
-      processed.anyOf = processed.oneOf.map(recurse)
-      delete processed.oneOf
-    }
-  }
-
-  if (processed.properties && typeof processed.properties === 'object') {
-    processed.properties = Object.fromEntries(
-      Object.entries(processed.properties).map(([key, value]) => [
-        key,
-        typeof value === 'object' ? simplifyRelationshipFields(value) : value,
-      ]),
-    )
-  }
-
-  if (processed.items && typeof processed.items === 'object' && !Array.isArray(processed.items)) {
-    processed.items = simplifyRelationshipFields(processed.items)
-  }
-
-  return processed
-}

package/src/utils/schemaConversion/transformPointFields.ts

@@ -1,56 +0,0 @@
-import type { JsonSchemaType } from '../../types.js'
-
-export function transformPointFieldsForMCP(schema: JsonSchemaType): JsonSchemaType {
-  if (!schema || typeof schema !== 'object') {
-    return schema
-  }
-
-  const transformed = { ...schema }
-
-  if (transformed.properties && typeof transformed.properties === 'object') {
-    transformed.properties = Object.fromEntries(
-      Object.entries(transformed.properties).map(([key, value]) => {
-        if (!value || typeof value !== 'object') {
-          return [key, value]
-        }
-        const isArrayType =
-          value.type === 'array' || (Array.isArray(value.type) && value.type.includes('array'))
-
-        if (
-          isArrayType &&
-          Array.isArray(value.items) &&
-          value.items.length === 2 &&
-          value.items.every((item) => item && typeof item === 'object' && item.type === 'number')
-        ) {
-          // Transform to object format
-          const isNullable = Array.isArray(value.type) && value.type.includes('null')
-
-          return [
-            key,
-            {
-              type: isNullable ? ['object', 'null'] : 'object',
-              description: value.description || 'Geographic coordinates (longitude, latitude)',
-              properties: {
-                latitude: { type: 'number', description: 'Latitude coordinate' },
-                longitude: { type: 'number', description: 'Longitude coordinate' },
-              },
-              required: ['longitude', 'latitude'],
-            },
-          ]
-        }
-
-        return [key, transformPointFieldsForMCP(value)]
-      }),
-    )
-  }
-
-  if (
-    transformed.items &&
-    typeof transformed.items === 'object' &&
-    !Array.isArray(transformed.items)
-  ) {
-    transformed.items = transformPointFieldsForMCP(transformed.items)
-  }
-
-  return transformed
-}