306 lines
No EOL
9 KiB
JSON
306 lines
No EOL
9 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"title": "MCP Server Detail",
|
|
"description": "Schema for a static representation of an MCP server. Used in various contexts related to discovery, installation, and configuration.",
|
|
"type": "object",
|
|
"required": [
|
|
"name",
|
|
"description",
|
|
"version_detail"
|
|
],
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Server name/identifier",
|
|
"example": "io.modelcontextprotocol/filesystem"
|
|
},
|
|
"description": {
|
|
"type": "string",
|
|
"description": "Human-readable description of the server's functionality",
|
|
"example": "Node.js server implementing Model Context Protocol (MCP) for filesystem operations."
|
|
},
|
|
"repository": {
|
|
"type": "object",
|
|
"description": "Canonical source repository information",
|
|
"required": [
|
|
"url",
|
|
"source",
|
|
"id"
|
|
],
|
|
"properties": {
|
|
"url": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"description": "Repository URL",
|
|
"example": "https://github.com/modelcontextprotocol/servers"
|
|
},
|
|
"source": {
|
|
"type": "string",
|
|
"enum": [
|
|
"github",
|
|
"gitlab"
|
|
],
|
|
"description": "Repository hosting service",
|
|
"example": "github"
|
|
},
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Repository identifier unique and immutable in the corresponding source",
|
|
"example": "b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9"
|
|
}
|
|
}
|
|
},
|
|
"version_detail": {
|
|
"type": "object",
|
|
"description": "Version information for this server",
|
|
"required": [
|
|
"version",
|
|
"release_date"
|
|
],
|
|
"properties": {
|
|
"version": {
|
|
"type": "string",
|
|
"description": "Server version (equivalent to Implementation.version in MCP spec)",
|
|
"example": "1.0.2"
|
|
},
|
|
"release_date": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "When this version was published to the registry",
|
|
"example": "2023-06-15T10:30:00Z"
|
|
}
|
|
}
|
|
},
|
|
"packages": {
|
|
"type": "array",
|
|
"description": "Available package distributions",
|
|
"items": {
|
|
"type": "object",
|
|
"required": [
|
|
"registry_name",
|
|
"name",
|
|
"version"
|
|
],
|
|
"properties": {
|
|
"registry_name": {
|
|
"type": "string",
|
|
"enum": [
|
|
"npm",
|
|
"docker",
|
|
"pypi",
|
|
"homebrew"
|
|
],
|
|
"description": "Package registry type",
|
|
"example": "npm"
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Package name in the registry",
|
|
"example": "@modelcontextprotocol/server-filesystem"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "Package version",
|
|
"example": "1.0.2"
|
|
},
|
|
"runtime_hint": {
|
|
"type": "string",
|
|
"description": "Hint for appropriate runtime (e.g., npx, uvx)",
|
|
"examples": [
|
|
"npx",
|
|
"uvx"
|
|
]
|
|
},
|
|
"runtime_arguments": {
|
|
"type": "array",
|
|
"description": "Arguments for the runtime command (docker, npx, etc.)",
|
|
"items": {
|
|
"$ref": "#/$defs/argument"
|
|
}
|
|
},
|
|
"package_arguments": {
|
|
"type": "array",
|
|
"description": "Arguments for the package binary",
|
|
"items": {
|
|
"$ref": "#/$defs/argument"
|
|
}
|
|
},
|
|
"environment_variables": {
|
|
"type": "array",
|
|
"description": "Environment variables to set",
|
|
"items": {
|
|
"$ref": "#/$defs/key_value_input"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"remotes": {
|
|
"type": "array",
|
|
"description": "Remote server endpoints",
|
|
"items": {
|
|
"type": "object",
|
|
"required": [
|
|
"transport_type",
|
|
"url"
|
|
],
|
|
"properties": {
|
|
"transport_type": {
|
|
"type": "string",
|
|
"enum": [
|
|
"streamable",
|
|
"sse"
|
|
],
|
|
"description": "Transport protocol type",
|
|
"example": "sse"
|
|
},
|
|
"url": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"description": "Remote server URL",
|
|
"example": "https://mcp-fs.example.com/sse"
|
|
},
|
|
"headers": {
|
|
"type": "array",
|
|
"description": "HTTP headers to include",
|
|
"items": {
|
|
"$ref": "#/$defs/key_value_input"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"$defs": {
|
|
"variable_map": {
|
|
"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": {
|
|
"type": "object",
|
|
"properties": {
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"format": {
|
|
"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": [
|
|
"string",
|
|
"number",
|
|
"boolean",
|
|
"filepath"
|
|
],
|
|
"default": "string"
|
|
},
|
|
"is_required": {
|
|
"type": "boolean"
|
|
},
|
|
"default": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"key_value_input": {
|
|
"type": "object",
|
|
"required": [
|
|
"name"
|
|
],
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Variable name"
|
|
},
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"default": {
|
|
"type": "string"
|
|
},
|
|
"is_required": {
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"is_secret": {
|
|
"type": "boolean",
|
|
"default": false
|
|
}
|
|
}
|
|
},
|
|
"argument": {
|
|
"oneOf": [
|
|
{
|
|
"type": "object",
|
|
"required": [
|
|
"type",
|
|
"value_hint"
|
|
],
|
|
"properties": {
|
|
"type": {
|
|
"const": "positional"
|
|
},
|
|
"value_hint": {
|
|
"type": "string",
|
|
"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": {
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"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": {
|
|
"type": "string"
|
|
},
|
|
"is_required": {
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"is_repeated": {
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"variables": {
|
|
"$ref": "#/$defs/variable_map"
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"type": "object",
|
|
"required": [
|
|
"type",
|
|
"name"
|
|
],
|
|
"properties": {
|
|
"type": {
|
|
"const": "named"
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Flag name including dashes"
|
|
},
|
|
"description": {
|
|
"type": "string"
|
|
},
|
|
"value": {
|
|
"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": {
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"is_repeated": {
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"variables": {
|
|
"$ref": "#/$defs/variable_map"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
} |