registry/internal/validators
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Mikel Olasagasti Uranga 7c446e75ad
feat(oci): add support for Quay.io registry (#1150)
Adds support for the Quay.io container registry to the OCI validator.
This allows MCP servers hosted on Quay.io to be registered and validated
by the official registry.

## Motivation and Context
<!-- Why is this change needed? What problem does it solve? -->

Quay.io is a major, trusted public OCI registry widely used by the
cloud-native and open-source communities. Currently, attempting to
publish a server using a Quay image results in an unsupported OCI
registry error. This change enables developers to use Quay.io as a
first-class hosting option for their MCP server images.

## How Has This Been Tested?
<!-- Have you tested this in a real application? Which scenarios were
tested? -->
- **Unit Tests:** Updated `internal/validators/registries/oci_test.go`
to transition Quay.io from a rejected test case to an allowed one.
- **Pattern Matching:** Verified that the allowlist correctly handles
both specific image identifiers and general pattern matching for the
`quay.io` host.
- **Local Validation:** Ran `make check` to ensure no regressions in the
existing OCI validation logic.

## Breaking Changes
<!-- Will users need to update their code or configurations? -->
No. This is an additive change that expands the allowlist of supported
registries. Existing configurations are unaffected.

## Types of changes
<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply: -->
- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [x] Documentation update

## Checklist
<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->
- [x] I have read the [MCP
Documentation](https://modelcontextprotocol.io)
- [x] My code follows the repository's style guidelines
- [x] New and existing tests pass locally
- [x] I have added appropriate error handling
- [x] I have added or updated documentation as needed

## Additional context
<!-- Add any other context, implementation notes, or design decisions
-->
The implementation follows the existing pattern for OCI registries:
1. Added a `RegistryURLQuay` constant to `pkg/model` for consistency.
2. Hardcoded `quay.io` into the `allowedOCIRegistries` map in the
validator to minimize architectural complexity.
3. Updated all relevant documentation files (`package-types.mdx`,
`generic-server-json.md`, and `official-registry-requirements.md`) to
ensure the source of truth is updated across the project.
4. Validation remains scoped to public images; no private registry
authentication was added for this host.

Signed-off-by: Mikel Olasagasti Uranga <mikel@olasagasti.info>
Co-authored-by: Radoslav Dimitrov <radoslav@stacklok.com>
2026-04-24 06:11:46 -04:00
..
registries feat(oci): add support for Quay.io registry (#1150) 2026-04-24 06:11:46 -04:00
schemas Enhanced server.json validation (phase 1) (#636) 2026-01-16 00:49:39 +02:00
constants.go feat: Add LocalTransport/RemoteTransport with URL template variables (#570) 2025-12-11 09:17:32 -08:00
package.go Add registry validators (#350) 2025-09-04 22:45:59 +01:00
schema.go Stop pinning Go to patch versions, use stable in CI (#1137) 2026-04-09 11:57:21 -04:00
schema_regex_test.go update schema url point to the actual location (#884) 2026-02-10 13:32:58 -08:00
schema_test.go Enhanced server.json validation (phase 1) (#636) 2026-01-16 00:49:39 +02:00
utils.go feat: Add LocalTransport/RemoteTransport with URL template variables (#570) 2025-12-11 09:17:32 -08:00
validation_detailed_test.go Enhanced server.json validation (phase 1) (#636) 2026-01-16 00:49:39 +02:00
validation_types.go Enhanced server.json validation (phase 1) (#636) 2026-01-16 00:49:39 +02:00
validation_types_test.go Enhanced server.json validation (phase 1) (#636) 2026-01-16 00:49:39 +02:00
validators.go Added /validate endpoint and modified mcp-publish so that all validation happens there (#896) 2026-02-04 15:52:07 +02:00
validators_test.go Enhanced server.json validation (phase 1) (#636) 2026-01-16 00:49:39 +02:00