docs(discovery): rename Catalog Entry mediaType field to type (ADR 0014)#32
Open
tadasant wants to merge 1 commit into
Open
docs(discovery): rename Catalog Entry mediaType field to type (ADR 0014)#32tadasant wants to merge 1 commit into
tadasant wants to merge 1 commit into
Conversation
Member
Author
|
Let's hold on merging until the AI Catalog PR lands |
Adapt the MCP Catalog Entry to AI Catalog PR #37 / ADR 0014, which renames the CatalogEntry `mediaType` member to `type` and reframes its description as an open-text type identifier rather than a strict IANA media type. Scoped to the field rename only. The value remains `application/mcp-server-card+json` (this repo's deliberate choice per issue ADR 0014's known-type `application/mcp-server+json`. The Server Card's own HTTP media type (Accept/Content-Type) is unchanged. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
8f2c327 to
0867422
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adapts the MCP Catalog Entry in
docs/discovery.mdto AI Catalog PR #37 / ADR 0014, which renames theCatalogEntry.mediaTypemember totypeand reframes its description as an open-text type identifier rather than a strict IANA media type.Changes (docs-only,
docs/discovery.md):mediaTypemember totypein the Catalog Entry table.typekey in all four example catalog entries.typeset to … / "ignore entries with unrecognized types").Scope decision — value deliberately kept as
application/mcp-server-card+jsonThis PR renames the field only. The value stays
application/mcp-server-card+jsonand is not changed to ADR 0014's known-typeapplication/mcp-server+json. Rationale:typean open-text format ("any string value is accepted");application/mcp-server+jsonis a non-binding "known type," and ecosystem types are "governed externally" (i.e., by MCP). So keeping a more precise MCP-governed value is compatible with ADR 0014, not a contradiction.application/mcp-server-card+jsonoverapplication/mcp-server+json(issue MCP Catalog mediaType (application/mcp-server+json) diverges from AI Catalog's application/mcp-server-card+json #9 / PR docs: align Catalog mediaType with AI Catalog spec #18) to avoid colliding with the MCP Registry'sserver.jsonconcept — a distinction the README documents in "Relationship to the MCP Registry."Flag for maintainers: AI Catalog's ADR 0014 known-types list uses
application/mcp-server+jsonfor MCP. Whether this repo should also adopt that value (reversing issue #9 / PR #18 and re-introducing theserver.jsonnaming collision) is a separate, more consequential decision and is intentionally out of scope here. Happy to file a cross-repo issue if maintainers want to pursue it.What is intentionally NOT changed
Accept/Content-Typenegotiation, the reserved/server-cardlocation prose). That is a genuine IANA media type, not the renamed catalog field, and ADR 0014 does not touch it.schema.ts/schema.json— the Server Card schema has nomediaType/typemember; this convention lives only in the discovery doc.This is a separate PR from #31 (the
urn:air:identifier adaptation); both touchdocs/discovery.mdand may need a trivial rebase depending on merge order.Verification
npm run check—schema.jsonup to date,tsc --noEmitcleannpm run validate— all 7 examples passnpm run format:check(prettier over tracked*.ts/*.json/*.md) — clean, including markdown table re-alignmentmediaTypefield tokens remain (git grep mediaType→ no matches)jbu/adr-0014-mediatype-to-type)🤖 Generated with Claude Code