modelcontextprotocol/registry
Watch
1
0
Fork
You've already forked registry
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

embed template in basic arg type, simpler k/v input for headers and env vars

Browse source
This commit is contained in:
Connor Peet 2025-05-13 10:11:51 -07:00
commit da32d8b472
2 changed files with 51 additions and 67 deletions
Download patch file Download diff file Expand all files Collapse all files

23
api/README.md
View file

@ -77,8 +77,7 @@ GET /v0/servers/a5e8a7f0-d4e4-4a1d-b12f-2896a23fd4f1?version=0.0.3
],
"environment_variables": [
{
"type": "named",
"name": "LOG_LEVEL",
"key": "LOG_LEVEL",
"description": "Logging level (debug, info, warn, error)",
"default": "info"
}
@ -90,9 +89,10 @@ GET /v0/servers/a5e8a7f0-d4e4-4a1d-b12f-2896a23fd4f1?version=0.0.3
"version": "1.0.2",
"runtime_arguments": [
{
"type": "template",
"type": "named",
"description": "Mount a volume into the container",
"template": "--mount=type=bind,src={source_path},dst={target_path}",
"flag": "--mount",
"value": "type=bind,src={source_path},dst={target_path}",
"is_required": true,
"is_repeated": true,
"variables": {
@ -115,11 +115,10 @@ GET /v0/servers/a5e8a7f0-d4e4-4a1d-b12f-2896a23fd4f1?version=0.0.3
"name": "target_dir",
"value": "/project",
}
]
],
"environment_variables": [
{
"type": "named",
"name": "LOG_LEVEL",
"key": "LOG_LEVEL",
"description": "Logging level (debug, info, warn, error)",
"default": "info"
}
@ -163,8 +162,7 @@ API Response:
"version": "1.0.2",
"environment_variables": [
{
"type": "named",
"name": "BRAVE_API_KEY",
"key": "BRAVE_API_KEY",
"description": "Brave Search API Key",
"is_required": true,
"is_secret": true
@ -217,9 +215,10 @@ API Response:
"version": "1.0.2",
"runtime_arguments": [
{
"type": "template",
"type": "named",
"description": "Mount a volume into the container",
"template": "--mount=type=bind,src={source_path},dst={target_path}",
"flag": "--mount",
"value": "type=bind,src={source_path},dst={target_path}",
"is_required": true,
"is_repeated": true,
"variables": {
@ -255,7 +254,7 @@ claude_desktop_config.json:
"server": "@modelcontextprotocol/servers/src/filesystem@1.0.2",
"package": "docker",
"settings": {
"mount_config": [
"--mount": [
{ "source_path": "/Users/username/Desktop", "target_path": "/project/desktop" },
{ "source_path": "/path/to/other/allowed/dir", "target_path": "/project/other/allowed/dir,ro" },
]

95
api/openapi.yaml
View file

@ -184,20 +184,18 @@ components:
type: array
description: List of arguments passed to the package's runtime command (such as docker or npx).
items:
$ref: '#/components/schemas/Input'
$ref: '#/components/schemas/Argument'
package_arguments:
type: array
description: List of arguments passed to the package's binary.
items:
$ref: '#/components/schemas/Input'
$ref: '#/components/schemas/Argument'
environment_variables:
type: array
items:
anyOf:
- $ref: '#/components/schemas/NamedInput'
- $ref: '#/components/schemas/TemplateInput'
$ref: '#/components/schemas/KeyValueInput'
UserInput:
Input:
type: object
properties:
description:
@ -213,7 +211,7 @@ components:
default: string
value:
type: string
description: The default value for the input. If this is not set, the user will be asked to provide a value.
description: The default value for the input. If this is not set, the user will be asked to provide a value. If the `variables` property is provided, then values wrapped in `{curly_braces}` will be replaced with the corresponding variables.
is_secret:
type: boolean
description: Whether the input is a secret value (e.g., password, token). If true, clients should handle the value securely.
@ -228,10 +226,21 @@ components:
type: string
example: []
PositionalInput:
InputWithVariables:
allOf:
- $ref: '#/components/schemas/Input'
- type: object
properties:
variables:
type: object
description: A map of variable names to their values. Keys in the input `value` wrapped in `{curly_braces}` will be replaced with the corresponding variables.
additionalProperties:
$ref: '#/components/schemas/Input'
PositionalArgument:
description: A positional input is a value inserted verbatim into the command line.
allOf:
- $ref: '#/components/schemas/UserInput'
- $ref: '#/components/schemas/InputWithVariables'
- type: object
required:
- type
@ -243,72 +252,50 @@ components:
example: "positional"
name:
type: string
description: Name of the positional argument. This is not part of the command line, but can be used for reference by client configuration.
description: Name of the positional argument. This is not part of the command line, but can be used for reference by client configuration and used to hint users.
example: file_path
is_repeated:
type: boolean
description: Whether the input can be repeated multiple times in the command line.
default: false
NamedInput:
description: A command-line `--flag={value}`, named environment variable or header.
NamedArgument:
description: A command-line `--flag={value}`.
allOf:
- $ref: '#/components/schemas/UserInput'
- $ref: '#/components/schemas/InputWithVariables'
- type: object
required:
- type
- name
- flag
properties:
type:
type: string
enum: [named]
example: "named"
name:
flag:
type: string
example: "--port"
is_repeated:
type: boolean
description: Whether the argument or header can be repeated multiple times. Has no effect for environment variables.
description: Whether the argument can be repeated multiple times. Has no effect for environment variables.
default: false
TemplateInput:
- type: object
required:
- type
- template
- name
properties:
type:
type: string
enum: [template]
name:
type: string
example: mount_config
description: The name of the input, which can be used by clients as an identifier to reference the input. For environment variables and headers, this is the environment variable or header names. For arguments, this is solely for reference and not part of the command line.
description:
description: A description of the input, which can be used by clients to provide context to the user.
type: string
is_required:
type: boolean
default: false
is_repeated:
type: boolean
description: Whether the argument or header can be repeated multiple times. Has no effect for environment variables.
default: false
template:
type: string
description: The template string that will be used to generate the value. Values wrapped in `{curly_braces}` will be replaced with the corresponding variables. Input which is not `is_required` is replaced with its `default` value, or otherwise an empty string.
example: "--mount=type=bind,src={host_path},dst={container_path}"
variables:
type: object
additionalProperties:
$ref: '#/components/schemas/UserInput'
KeyValueInput:
allOf:
- $ref: '#/components/schemas/InputWithVariables'
- type: object
required:
- name
properties:
key:
type: string
description: Name of the header or environment variable.
example: SOME_VARIABLE
Input:
Argument:
anyOf:
- $ref: '#/components/schemas/PositionalInput'
- $ref: '#/components/schemas/NamedInput'
- $ref: '#/components/schemas/TemplateInput'
- $ref: '#/components/schemas/PositionalArgument'
- $ref: '#/components/schemas/NamedArgument'
Remote:
type: object
@ -327,9 +314,7 @@ components:
headers:
type: array
items:
anyOf:
- $ref: '#/components/schemas/NamedInput'
- $ref: '#/components/schemas/TemplateInput'
$ref: '#/components/schemas/KeyValueInput'
ServerDetail:
allOf: