Address feedback

This commit is contained in:
tadasant 2025-06-27 14:20:35 -07:00 • committed by Toby Padilla
commit 01b818f5b7
2 changed files with 11 additions and 7 deletions

View file

@ -5,7 +5,7 @@ There are a variety of use cases where a _static representation of an MCP server
- Discoverability on a decentralized `.well-known` endpoint - Discoverability on a decentralized `.well-known` endpoint
- As a response to an initialization call, so the client knows information about the MCP server to which it is connecting - As a response to an initialization call, so the client knows information about the MCP server to which it is connecting
- As an input into crafting a [DXT file](https://www.anthropic.com/engineering/desktop-extensions) - As an input into crafting a [DXT file](https://www.anthropic.com/engineering/desktop-extensions)
- Packaged in with the source code of an MCP server, so as to have a structured way context - Packaged in with the source code of an MCP server, so as to have a structured way to identify a server given just its source code
All of these scenarios (and more) would benefit from an agreed-upon, standardized format that makes it easy to port around and maintain a consistent experience for consumers and developers working with the data. At the end of the day, it's all the same data (or a subset of it). MCP server maintainers should have to manage one copy of this file, and all these use cases can serve that file (or a programmatic derivative/subset of it). All of these scenarios (and more) would benefit from an agreed-upon, standardized format that makes it easy to port around and maintain a consistent experience for consumers and developers working with the data. At the end of the day, it's all the same data (or a subset of it). MCP server maintainers should have to manage one copy of this file, and all these use cases can serve that file (or a programmatic derivative/subset of it).

View file

@ -55,8 +55,7 @@
"description": "Version information for this server", "description": "Version information for this server",
"required": [ "required": [
"version", "version",
"release_date", "release_date"
"is_latest"
], ],
"properties": { "properties": {
"version": { "version": {
@ -129,13 +128,14 @@
}, },
"value_hint": { "value_hint": {
"type": "string", "type": "string",
"description": "Identifier hint for the value" "description": "An identifier-like hint for the value. This is not part of the command line, but can be used by client configuration and to provide hints to users."
}, },
"description": { "description": {
"type": "string" "type": "string"
}, },
"value": { "value": {
"type": "string" "type": "string",
"description": "The default value for the input. If this is not set, the user may be prompted to provide a value.\n\nIdentifiers wrapped in `{curly_braces}` will be replaced with the corresponding properties from the input `variables` map. If an identifier in braces is not found in `variables`, or if `variables` is not provided, the `{curly_braces}` substring should remain unchanged."
}, },
"default": { "default": {
"type": "string" "type": "string"
@ -168,7 +168,8 @@
"type": "string" "type": "string"
}, },
"value": { "value": {
"type": "string" "type": "string",
"description": "The default value for the input. If this is not set, the user may be prompted to provide a value.\n\nIdentifiers wrapped in `{curly_braces}` will be replaced with the corresponding properties from the input `variables` map. If an identifier in braces is not found in `variables`, or if `variables` is not provided, the `{curly_braces}` substring should remain unchanged."
}, },
"is_required": { "is_required": {
"type": "boolean", "type": "boolean",
@ -180,6 +181,7 @@
}, },
"variables": { "variables": {
"type": "object", "type": "object",
"description": "A map of variable names to their values. Keys in the input `value` that are wrapped in `{curly_braces}` will be replaced with the corresponding variable values.",
"additionalProperties": { "additionalProperties": {
"type": "object", "type": "object",
"properties": { "properties": {
@ -188,12 +190,14 @@
}, },
"format": { "format": {
"type": "string", "type": "string",
"description": "Specifies the input format. Supported values include `filepath`, which should be interpreted as a file on the user's filesystem.\n\nWhen the input is converted to a string, booleans should be represented by the strings \"true\" and \"false\", and numbers should be represented as decimal values.",
"enum": [ "enum": [
"string", "string",
"number", "number",
"boolean", "boolean",
"filepath" "filepath"
] ],
"default": "string"
}, },
"is_required": { "is_required": {
"type": "boolean" "type": "boolean"