Merge pull request #138 from anthropics/feat/export-versioned-schemas
feat: export versioned schemas in package.json
This commit is contained in:
commit
11d1397ee8
14 changed files with 1179 additions and 53 deletions
|
|
@ -46,6 +46,7 @@ To set up commit signing, see [GitHub's documentation on commit signature verifi
|
||||||
### Bug Reports
|
### Bug Reports
|
||||||
|
|
||||||
When filing a bug report, please include:
|
When filing a bug report, please include:
|
||||||
|
|
||||||
- Clear description of the issue
|
- Clear description of the issue
|
||||||
- Steps to reproduce
|
- Steps to reproduce
|
||||||
- Expected vs actual behavior
|
- Expected vs actual behavior
|
||||||
|
|
@ -55,6 +56,7 @@ When filing a bug report, please include:
|
||||||
### Feature Requests
|
### Feature Requests
|
||||||
|
|
||||||
We welcome feature suggestions! Please:
|
We welcome feature suggestions! Please:
|
||||||
|
|
||||||
- Clearly describe the feature and use case
|
- Clearly describe the feature and use case
|
||||||
- Explain why this would be valuable to users
|
- Explain why this would be valuable to users
|
||||||
- Consider if it aligns with the project's goals
|
- Consider if it aligns with the project's goals
|
||||||
|
|
@ -62,6 +64,7 @@ We welcome feature suggestions! Please:
|
||||||
### Code Contributions
|
### Code Contributions
|
||||||
|
|
||||||
We especially welcome:
|
We especially welcome:
|
||||||
|
|
||||||
- Bug fixes
|
- Bug fixes
|
||||||
- Documentation improvements
|
- Documentation improvements
|
||||||
- Test coverage improvements
|
- Test coverage improvements
|
||||||
|
|
|
||||||
18
MANIFEST.md
18
MANIFEST.md
|
|
@ -17,7 +17,7 @@ A basic `manifest.json` with just the required fields looks like this:
|
||||||
"description": "A simple MCP extension", // Brief description of what the extension does
|
"description": "A simple MCP extension", // Brief description of what the extension does
|
||||||
"author": {
|
"author": {
|
||||||
// Author information (required)
|
// Author information (required)
|
||||||
"name": "Extension Author" // Author's name (required field)
|
"name": "Extension Author", // Author's name (required field)
|
||||||
},
|
},
|
||||||
"server": {
|
"server": {
|
||||||
// Server configuration (required)
|
// Server configuration (required)
|
||||||
|
|
@ -28,10 +28,10 @@ A basic `manifest.json` with just the required fields looks like this:
|
||||||
"command": "node", // Command to run the server
|
"command": "node", // Command to run the server
|
||||||
"args": [
|
"args": [
|
||||||
// Arguments passed to the command
|
// Arguments passed to the command
|
||||||
"${__dirname}/server/index.js" // ${__dirname} is replaced with the extension's directory
|
"${__dirname}/server/index.js", // ${__dirname} is replaced with the extension's directory
|
||||||
]
|
],
|
||||||
}
|
},
|
||||||
}
|
},
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -212,12 +212,12 @@ A full `manifest.json` with most of the optional fields looks like this:
|
||||||
"type": "string"
|
"type": "string"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
},
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -254,7 +254,7 @@ A full `manifest.json` with most of the optional fields looks like this:
|
||||||
- **privacy_policies**: Array of URLs to privacy policies for external services that handle user data. Required when the extension connects to external services (first- or third-party) that process user data. Each URL should link to the respective service's privacy policy document.
|
- **privacy_policies**: Array of URLs to privacy policies for external services that handle user data. Required when the extension connects to external services (first- or third-party) that process user data. Each URL should link to the respective service's privacy policy document.
|
||||||
- **compatibility**: Compatibility requirements (client app version, platforms, and runtime versions).
|
- **compatibility**: Compatibility requirements (client app version, platforms, and runtime versions).
|
||||||
- **user_config**: User-configurable options for the extension (see User Configuration section).
|
- **user_config**: User-configurable options for the extension (see User Configuration section).
|
||||||
- **_meta**: Platform-specific client integration metadata (e.g., Windows `package_family_name`, macOS bundle identifiers) enabling tighter OS/app store integration. The keys in the `_meta` object are reverse-DNS namespaced, and the values are a dictionary of platform-specific metadata.
|
- **\_meta**: Platform-specific client integration metadata (e.g., Windows `package_family_name`, macOS bundle identifiers) enabling tighter OS/app store integration. The keys in the `_meta` object are reverse-DNS namespaced, and the values are a dictionary of platform-specific metadata.
|
||||||
- **localization**: Location of translated strings for user-facing fields (`resources` path containing a `${locale}` placeholder and `default_locale`).
|
- **localization**: Location of translated strings for user-facing fields (`resources` path containing a `${locale}` placeholder and `default_locale`).
|
||||||
|
|
||||||
### Localization
|
### Localization
|
||||||
|
|
@ -277,6 +277,7 @@ Provide localized strings without bloating the manifest by pointing to external
|
||||||
For tools and prompts, the descriptions are also localizable.
|
For tools and prompts, the descriptions are also localizable.
|
||||||
|
|
||||||
#### Client guidelines
|
#### Client guidelines
|
||||||
|
|
||||||
- if a client wants to show tool or prompt descriptions in their UI, the client should look for the locale-specific description override in the corresponding per-locale file.
|
- if a client wants to show tool or prompt descriptions in their UI, the client should look for the locale-specific description override in the corresponding per-locale file.
|
||||||
- clients should only look for tools/prompts present in the manifest.json, i.e. prompts and tools that only exist in the per-locale file should be ignored.
|
- clients should only look for tools/prompts present in the manifest.json, i.e. prompts and tools that only exist in the per-locale file should be ignored.
|
||||||
- Clients should apply locale fallbacks if the client/user locale is not represented by the server. For example, if the user is in the `es-UY` locale but the server does not include that per-locale file, the client should look for an approrpiate fallback, e.g. `es-MX` or `es-ES`, or fall back to the values in the manifest.
|
- Clients should apply locale fallbacks if the client/user locale is not represented by the server. For example, if the user is in the `es-UY` locale but the server does not include that per-locale file, the client should look for an approrpiate fallback, e.g. `es-MX` or `es-ES`, or fall back to the values in the manifest.
|
||||||
|
|
@ -712,4 +713,3 @@ The `_generated` fields:
|
||||||
- **prompts_generated**: Server generates additional prompts beyond those listed (default: false)
|
- **prompts_generated**: Server generates additional prompts beyond those listed (default: false)
|
||||||
|
|
||||||
This helps implementing apps understand that querying the server at runtime will reveal more capabilities than what's declared in the manifest.
|
This helps implementing apps understand that querying the server at runtime will reveal more capabilities than what's declared in the manifest.
|
||||||
|
|
||||||
|
|
|
||||||
22
package.json
22
package.json
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"name": "@anthropic-ai/mcpb",
|
"name": "@anthropic-ai/mcpb",
|
||||||
"description": "Tools for building MCP Bundles",
|
"description": "Tools for building MCP Bundles",
|
||||||
"version": "1.1.2",
|
"version": "1.1.3",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"main": "dist/index.js",
|
"main": "dist/index.js",
|
||||||
"module": "dist/index.js",
|
"module": "dist/index.js",
|
||||||
|
|
@ -27,7 +27,25 @@
|
||||||
"import": "./dist/cli.js",
|
"import": "./dist/cli.js",
|
||||||
"require": "./dist/cli.js"
|
"require": "./dist/cli.js"
|
||||||
},
|
},
|
||||||
"./mcpb-manifest.schema.json": "./dist/mcpb-manifest.schema.json"
|
"./mcpb-manifest-v0.1.schema.json": "./dist/mcpb-manifest-v0.1.schema.json",
|
||||||
|
"./mcpb-manifest-v0.2.schema.json": "./dist/mcpb-manifest-v0.2.schema.json",
|
||||||
|
"./mcpb-manifest-v0.3.schema.json": "./dist/mcpb-manifest-v0.3.schema.json",
|
||||||
|
"./mcpb-manifest-latest.schema.json": "./dist/mcpb-manifest-latest.schema.json",
|
||||||
|
"./schemas": {
|
||||||
|
"types": "./dist/schemas/index.d.ts",
|
||||||
|
"import": "./dist/schemas/index.js",
|
||||||
|
"require": "./dist/schemas/index.js"
|
||||||
|
},
|
||||||
|
"./schemas/*": {
|
||||||
|
"types": "./dist/schemas/*.d.ts",
|
||||||
|
"import": "./dist/schemas/*.js",
|
||||||
|
"require": "./dist/schemas/*.js"
|
||||||
|
},
|
||||||
|
"./schemas-loose": {
|
||||||
|
"types": "./dist/schemas-loose.d.ts",
|
||||||
|
"import": "./dist/schemas-loose.js",
|
||||||
|
"require": "./dist/schemas-loose.js"
|
||||||
|
}
|
||||||
},
|
},
|
||||||
"bin": "dist/cli/cli.js",
|
"bin": "dist/cli/cli.js",
|
||||||
"files": [
|
"files": [
|
||||||
|
|
|
||||||
376
schemas/mcpb-manifest-latest.schema.json
Normal file
376
schemas/mcpb-manifest-latest.schema.json
Normal file
|
|
@ -0,0 +1,376 @@
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"dxt_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.3",
|
||||||
|
"description": "@deprecated Use manifest_version instead"
|
||||||
|
},
|
||||||
|
"manifest_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.3"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"display_name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"long_description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"author": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"email": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "email"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"homepage": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"documentation": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"support": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"icon": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"icons": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"src": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"sizes": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^\\d+x\\d+$"
|
||||||
|
},
|
||||||
|
"theme": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"src",
|
||||||
|
"sizes"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"screenshots": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"localization": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"resources": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "\\$\\{locale\\}"
|
||||||
|
},
|
||||||
|
"default_locale": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[A-Za-z0-9]{2,8}(?:-[A-Za-z0-9]{1,8})*$"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"resources",
|
||||||
|
"default_locale"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"server": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"python",
|
||||||
|
"node",
|
||||||
|
"binary"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"entry_point": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"mcp_config": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"platform_overrides": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/command"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/args"
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/env"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"command"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"entry_point",
|
||||||
|
"mcp_config"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"tools": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"tools_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"prompts": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"arguments": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"text": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"text"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"prompts_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"keywords": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"license": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"privacy_policies": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"compatibility": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"claude_desktop": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"platforms": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"darwin",
|
||||||
|
"win32",
|
||||||
|
"linux"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"runtimes": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"python": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"node": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"user_config": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"string",
|
||||||
|
"number",
|
||||||
|
"boolean",
|
||||||
|
"directory",
|
||||||
|
"file"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"title": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"required": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"default": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"multiple": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"sensitive": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"min": {
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "number"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"title",
|
||||||
|
"description"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"_meta": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"description",
|
||||||
|
"author",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"additionalProperties": false,
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#"
|
||||||
|
}
|
||||||
327
schemas/mcpb-manifest-v0.1.schema.json
Normal file
327
schemas/mcpb-manifest-v0.1.schema.json
Normal file
|
|
@ -0,0 +1,327 @@
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"dxt_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.1",
|
||||||
|
"description": "@deprecated Use manifest_version instead"
|
||||||
|
},
|
||||||
|
"manifest_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.1"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"display_name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"long_description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"author": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"email": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "email"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"homepage": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"documentation": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"support": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"icon": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"screenshots": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"server": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"python",
|
||||||
|
"node",
|
||||||
|
"binary"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"entry_point": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"mcp_config": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"platform_overrides": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/command"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/args"
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/env"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"command"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"entry_point",
|
||||||
|
"mcp_config"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"tools": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"tools_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"prompts": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"arguments": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"text": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"text"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"prompts_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"keywords": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"license": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"compatibility": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"claude_desktop": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"platforms": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"darwin",
|
||||||
|
"win32",
|
||||||
|
"linux"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"runtimes": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"python": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"node": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"user_config": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"string",
|
||||||
|
"number",
|
||||||
|
"boolean",
|
||||||
|
"directory",
|
||||||
|
"file"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"title": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"required": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"default": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"multiple": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"sensitive": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"min": {
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "number"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"title",
|
||||||
|
"description"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"_meta": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"description",
|
||||||
|
"author",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"additionalProperties": false,
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#"
|
||||||
|
}
|
||||||
327
schemas/mcpb-manifest-v0.2.schema.json
Normal file
327
schemas/mcpb-manifest-v0.2.schema.json
Normal file
|
|
@ -0,0 +1,327 @@
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"dxt_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.2",
|
||||||
|
"description": "@deprecated Use manifest_version instead"
|
||||||
|
},
|
||||||
|
"manifest_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.2"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"display_name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"long_description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"author": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"email": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "email"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"homepage": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"documentation": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"support": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"icon": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"screenshots": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"server": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"python",
|
||||||
|
"node",
|
||||||
|
"binary"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"entry_point": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"mcp_config": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"platform_overrides": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/command"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/args"
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/env"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"command"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"entry_point",
|
||||||
|
"mcp_config"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"tools": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"tools_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"prompts": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"arguments": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"text": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"text"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"prompts_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"keywords": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"license": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"privacy_policies": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"compatibility": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"claude_desktop": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"platforms": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"darwin",
|
||||||
|
"win32",
|
||||||
|
"linux"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"runtimes": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"python": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"node": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"user_config": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"string",
|
||||||
|
"number",
|
||||||
|
"boolean",
|
||||||
|
"directory",
|
||||||
|
"file"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"title": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"required": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"default": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"multiple": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"sensitive": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"min": {
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "number"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"title",
|
||||||
|
"description"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"description",
|
||||||
|
"author",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"additionalProperties": false,
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#"
|
||||||
|
}
|
||||||
376
schemas/mcpb-manifest-v0.3.schema.json
Normal file
376
schemas/mcpb-manifest-v0.3.schema.json
Normal file
|
|
@ -0,0 +1,376 @@
|
||||||
|
{
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"$schema": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"dxt_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.3",
|
||||||
|
"description": "@deprecated Use manifest_version instead"
|
||||||
|
},
|
||||||
|
"manifest_version": {
|
||||||
|
"type": "string",
|
||||||
|
"const": "0.3"
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"display_name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"version": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"long_description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"author": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"email": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "email"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"repository": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"url": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"url"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"homepage": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"documentation": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"support": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
},
|
||||||
|
"icon": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"icons": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"src": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"sizes": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^\\d+x\\d+$"
|
||||||
|
},
|
||||||
|
"theme": {
|
||||||
|
"type": "string",
|
||||||
|
"minLength": 1
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"src",
|
||||||
|
"sizes"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"screenshots": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"localization": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"resources": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "\\$\\{locale\\}"
|
||||||
|
},
|
||||||
|
"default_locale": {
|
||||||
|
"type": "string",
|
||||||
|
"pattern": "^[A-Za-z0-9]{2,8}(?:-[A-Za-z0-9]{1,8})*$"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"resources",
|
||||||
|
"default_locale"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"server": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"python",
|
||||||
|
"node",
|
||||||
|
"binary"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"entry_point": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"mcp_config": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"platform_overrides": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"command": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/command"
|
||||||
|
},
|
||||||
|
"args": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/args"
|
||||||
|
},
|
||||||
|
"env": {
|
||||||
|
"$ref": "#/properties/server/properties/mcp_config/properties/env"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"command"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"entry_point",
|
||||||
|
"mcp_config"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"tools": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"tools_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"prompts": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"name": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"arguments": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"text": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"text"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"prompts_generated": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"keywords": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"license": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"privacy_policies": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"format": "uri"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"compatibility": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"claude_desktop": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"platforms": {
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"darwin",
|
||||||
|
"win32",
|
||||||
|
"linux"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"runtimes": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"python": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"node": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"user_config": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"type": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"string",
|
||||||
|
"number",
|
||||||
|
"boolean",
|
||||||
|
"directory",
|
||||||
|
"file"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"title": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"description": {
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"required": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"default": {
|
||||||
|
"anyOf": [
|
||||||
|
{
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"multiple": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"sensitive": {
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"min": {
|
||||||
|
"type": "number"
|
||||||
|
},
|
||||||
|
"max": {
|
||||||
|
"type": "number"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"type",
|
||||||
|
"title",
|
||||||
|
"description"
|
||||||
|
],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"_meta": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {
|
||||||
|
"type": "object",
|
||||||
|
"additionalProperties": {}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"name",
|
||||||
|
"version",
|
||||||
|
"description",
|
||||||
|
"author",
|
||||||
|
"server"
|
||||||
|
],
|
||||||
|
"additionalProperties": false,
|
||||||
|
"$schema": "http://json-schema.org/draft-07/schema#"
|
||||||
|
}
|
||||||
|
|
@ -1,33 +1,48 @@
|
||||||
import {
|
import {
|
||||||
McpbManifestSchema,
|
McpbManifestSchema as McpbManifestSchemaLatest,
|
||||||
McpbSignatureInfoSchema,
|
McpbSignatureInfoSchema,
|
||||||
} from "../dist/schemas/latest.js";
|
} from "../dist/schemas/latest.js";
|
||||||
|
import { McpbManifestSchema as McpbManifestSchema_v0_1 } from "../dist/schemas/0.1.js";
|
||||||
|
import { McpbManifestSchema as McpbManifestSchema_v0_2 } from "../dist/schemas/0.2.js";
|
||||||
|
import { McpbManifestSchema as McpbManifestSchema_v0_3 } from "../dist/schemas/0.3.js";
|
||||||
import { zodToJsonSchema } from "zod-to-json-schema";
|
import { zodToJsonSchema } from "zod-to-json-schema";
|
||||||
import fs from "node:fs/promises";
|
import fs from "node:fs/promises";
|
||||||
import path from "node:path";
|
import path from "node:path";
|
||||||
|
|
||||||
const schemasToWrite = {
|
|
||||||
"mcpb-manifest": McpbManifestSchema,
|
|
||||||
"mcpb-signature-info": McpbSignatureInfoSchema,
|
|
||||||
};
|
|
||||||
|
|
||||||
const distDir = path.join(import.meta.dirname, "../dist");
|
const distDir = path.join(import.meta.dirname, "../dist");
|
||||||
const schemasDir = path.join(import.meta.dirname, "../schemas");
|
const schemasDir = path.join(import.meta.dirname, "../schemas");
|
||||||
|
|
||||||
|
// Versioned manifest schemas
|
||||||
|
const versionedManifestSchemas = {
|
||||||
|
"mcpb-manifest-v0.1": McpbManifestSchema_v0_1,
|
||||||
|
"mcpb-manifest-v0.2": McpbManifestSchema_v0_2,
|
||||||
|
"mcpb-manifest-v0.3": McpbManifestSchema_v0_3,
|
||||||
|
"mcpb-manifest-latest": McpbManifestSchemaLatest,
|
||||||
|
};
|
||||||
|
|
||||||
|
// Other schemas
|
||||||
|
const otherSchemas = {
|
||||||
|
"mcpb-signature-info": McpbSignatureInfoSchema,
|
||||||
|
};
|
||||||
|
|
||||||
|
const allSchemas = { ...versionedManifestSchemas, ...otherSchemas };
|
||||||
|
|
||||||
// Generate all schemas to dist/
|
// Generate all schemas to dist/
|
||||||
await fs.mkdir(distDir, { recursive: true });
|
await fs.mkdir(distDir, { recursive: true });
|
||||||
for (const key in schemasToWrite) {
|
for (const [key, schema] of Object.entries(allSchemas)) {
|
||||||
const schema = zodToJsonSchema(schemasToWrite[key]);
|
const jsonSchema = zodToJsonSchema(schema);
|
||||||
const filePath = path.join(distDir, `${key}.schema.json`);
|
const filePath = path.join(distDir, `${key}.schema.json`);
|
||||||
await fs.writeFile(filePath, JSON.stringify(schema, null, 2), {
|
await fs.writeFile(filePath, JSON.stringify(jsonSchema, null, 2), {
|
||||||
encoding: "utf8",
|
encoding: "utf8",
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
// Generate only manifest schema to schemas/
|
// Generate all versioned manifest schemas to schemas/
|
||||||
await fs.mkdir(schemasDir, { recursive: true });
|
await fs.mkdir(schemasDir, { recursive: true });
|
||||||
const manifestSchema = zodToJsonSchema(McpbManifestSchema);
|
for (const [key, schema] of Object.entries(versionedManifestSchemas)) {
|
||||||
const manifestPath = path.join(schemasDir, "mcpb-manifest.schema.json");
|
const jsonSchema = zodToJsonSchema(schema);
|
||||||
await fs.writeFile(manifestPath, JSON.stringify(manifestSchema, null, 2), {
|
const filePath = path.join(schemasDir, `${key}.schema.json`);
|
||||||
encoding: "utf8",
|
await fs.writeFile(filePath, JSON.stringify(jsonSchema, null, 2), {
|
||||||
});
|
encoding: "utf8",
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
|
||||||
15
src/schemas/any.ts
Normal file
15
src/schemas/any.ts
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
import * as z from "zod";
|
||||||
|
|
||||||
|
import * as v0_1 from "./0.1.js";
|
||||||
|
import * as v0_2 from "./0.2.js";
|
||||||
|
import * as v0_3 from "./0.3.js";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Union schema that accepts any supported manifest version (0.1, 0.2, 0.3).
|
||||||
|
* Use this when you need to validate manifests of any version.
|
||||||
|
*/
|
||||||
|
export const McpbManifestSchema = z.union([
|
||||||
|
v0_1.McpbManifestSchema,
|
||||||
|
v0_2.McpbManifestSchema,
|
||||||
|
v0_3.McpbManifestSchema,
|
||||||
|
]);
|
||||||
|
|
@ -1,6 +1,7 @@
|
||||||
export * as v0_1 from "./0.1.js";
|
export * as v0_1 from "./0.1.js";
|
||||||
export * as v0_2 from "./0.2.js";
|
export * as v0_2 from "./0.2.js";
|
||||||
export * as v0_3 from "./0.3.js";
|
export * as v0_3 from "./0.3.js";
|
||||||
|
export * as any from "./any.js";
|
||||||
export * as latest from "./latest.js";
|
export * as latest from "./latest.js";
|
||||||
export {
|
export {
|
||||||
MANIFEST_VERSION as LATEST_MANIFEST_VERSION,
|
MANIFEST_VERSION as LATEST_MANIFEST_VERSION,
|
||||||
|
|
|
||||||
|
|
@ -335,5 +335,4 @@ describe("McpbManifestSchema", () => {
|
||||||
expect(result.success).toBe(true);
|
expect(result.success).toBe(true);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
});
|
});
|
||||||
|
|
|
||||||
|
|
@ -1,21 +1,19 @@
|
||||||
{
|
{
|
||||||
"manifest_version": "0.2",
|
"manifest_version": "0.2",
|
||||||
"name": "legacy-extension",
|
"name": "legacy-extension",
|
||||||
"display_name": "Legacy Extension",
|
"display_name": "Legacy Extension",
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"description": "An extension that predates 0.3",
|
"description": "An extension that predates 0.3",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Legacy Author",
|
"name": "Legacy Author",
|
||||||
"email": "legacy@example.com"
|
"email": "legacy@example.com"
|
||||||
},
|
},
|
||||||
"server": {
|
"server": {
|
||||||
"type": "node",
|
"type": "node",
|
||||||
"entry_point": "server/index.js",
|
"entry_point": "server/index.js",
|
||||||
"mcp_config": {
|
"mcp_config": {
|
||||||
"command": "node",
|
"command": "node",
|
||||||
"args": [
|
"args": ["${__dirname}/server/index.js"]
|
||||||
"${__dirname}/server/index.js"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
@ -13,9 +13,7 @@
|
||||||
"entry_point": "server/index.js",
|
"entry_point": "server/index.js",
|
||||||
"mcp_config": {
|
"mcp_config": {
|
||||||
"command": "node",
|
"command": "node",
|
||||||
"args": [
|
"args": ["${__dirname}/server/index.js"]
|
||||||
"${__dirname}/server/index.js"
|
|
||||||
]
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
Loading…
Reference in a new issue