modelcontextprotocol / modelcontextprotocol/registry
Clarify approach to managing server.json schema versions
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 7.3k
- Forks
- 994
- Avg merge
- 4d 12h
- Merged PRs (30d)
- 19
Description
I think the state we want to be in is:
- Registry code (including API and CLI) uses exclusively finalized versions of server.json from https://github.com/modelcontextprotocol/static/tree/main/schemas
- This file is a
draftthat should not be used by any systems (neither registry code nor others) until it is finalized and in thestaticrepo - After a server.json version release to static, we should always cut a ticket to update the registry code (API and CLI) to use the new version
If agreed, we should:
- Change that server.schema.json $id field to point to
draft - Document the sequencing for handling server.schema.json changes in accordance with the above
Are there any dependencies between our code and that server.schema.json field right now? If so, I think we should sever them and have the API/CLI code reference the static versions.
See: https://discord.com/channels/1358869848138059966/1369487942862504016/1424904131331625031
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by checking whether the registry API or CLI references docs/reference/server-json/server.schema.json, then compare those references with finalized versions in the static repository. Confirm the draft $id and document the sequencing for schema changes. Done means the API and CLI use finalized static versions and the update process is recorded.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go, json
- Domain
- api, cli, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100