modelcontextprotocol / modelcontextprotocol/registry

Clarify approach to managing server.json schema versions

Open
#622 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

v1
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 draft that should not be used by any systems (neither registry code nor others) until it is finalized and in the static repo
  • 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:

  1. Change that server.schema.json $id field to point to draft
  2. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.