Add schema version to server.json in MCP template #6606
Merged
Conversation
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
There was a problem hiding this comment.
Pull Request Overview
Adds a $schema reference to the server.json template to encode the current draft schema version.
- Introduces a
$schemaproperty pointing to the draft schema with date 2025-07-09 - Ensures the template is aligned with the registry’s schema identifier
Comments suppressed due to low confidence (1)
src/ProjectTemplates/Microsoft.Extensions.AI.Templates/src/McpServer/McpServer-CSharp/.mcp/server.json:2
- [nitpick] Verify that the
$schemaURI exactly matches the$iddefined in the draft schema (including the date segment). If you need schema stability for JSON validators, consider linking to a raw GitHub URL with a specific git ref to lock the version.
"$schema": "https://modelcontextprotocol.io/schemas/draft/2025-07-09/server.json",
jeffhandley
approved these changes
Jul 14, 2025
jeffhandley
pushed a commit
to jeffhandley/extensions
that referenced
this pull request
Jul 14, 2025
* Add schema version to server.json * Fix test
jeffhandley
pushed a commit
that referenced
this pull request
Jul 15, 2025
* Add schema version to server.json * Fix test
This was referenced Aug 13, 2025
Merged
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
The server.json schema is in draft mode, so this PR is an attempt to encode which version of the schema is being used here, despite it being draft (prerelease).
The schema is defined here:
https://github.com/modelcontextprotocol/registry/blob/main/docs/server-json/schema.json
Note that the
$schemavalue right now is a URI not a URL.We could opt to point to the raw.githubusercontent.com URL but this would mean the
$schemavalue diverges from$idcurrently used by the JSON schema. Also, if we pick a URL to GitHub, we would need to use a git ref in the URL which perhaps is not the worst but it would be a 2nd way of expressing the schema version (in addition to the date).See modelcontextprotocol/registry#167 (comment).
Microsoft Reviewers: Open in CodeFlow