diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
new file mode 100644
index 0000000..52d6e4d
--- /dev/null
+++ b/.github/workflows/main.yml
@@ -0,0 +1,27 @@
+on:
+ push:
+ branches:
+ - main
+
+ pull_request:
+
+jobs:
+ validate:
+ runs-on: ubuntu-latest
+
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v2
+ with:
+ node-version: 20
+ cache: yarn
+
+ - run: yarn install --immutable
+
+ - run: yarn validate:schema
+
+ - run: yarn generate:json
+ - name: Verify that `yarn generate:json` did not change outputs (if it did, please re-run it and re-commit!)
+ run: git diff --exit-code
+
+ - run: yarn validate:examples
diff --git a/.github/workflows/site.yml b/.github/workflows/site.yml
new file mode 100644
index 0000000..97ab245
--- /dev/null
+++ b/.github/workflows/site.yml
@@ -0,0 +1,79 @@
+# Sample workflow for building and deploying a Hugo site to GitHub Pages
+name: Deploy Hugo site to Pages
+
+on:
+ # Runs on pushes targeting the default branch
+ push:
+ branches:
+ - main
+
+ # Allows you to run this workflow manually from the Actions tab
+ workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+ group: "pages"
+ cancel-in-progress: false
+
+# Default to bash
+defaults:
+ run:
+ shell: bash
+
+jobs:
+ # Build job
+ build:
+ runs-on: ubuntu-latest
+ env:
+ HUGO_VERSION: 0.134.2
+ steps:
+ - name: Install Hugo CLI
+ run: |
+ wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+ && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+ - name: Install Dart Sass
+ run: sudo snap install dart-sass
+ - name: Checkout
+ uses: actions/checkout@v4
+ with:
+ submodules: recursive
+ fetch-depth: 0
+ - name: Setup Pages
+ id: pages
+ uses: actions/configure-pages@v5
+ - name: Install Node.js dependencies
+ run: "[[ -f site/package-lock.json || -f site/npm-shrinkwrap.json ]] && npm ci --prefix site || true"
+ - name: Build with Hugo
+ env:
+ HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
+ HUGO_ENVIRONMENT: production
+ TZ: America/Los_Angeles
+ run: |
+ hugo \
+ --gc \
+ --minify \
+ --baseURL "${{ steps.pages.outputs.base_url }}/" \
+ -s site
+ - name: Upload artifact
+ uses: actions/upload-pages-artifact@v3
+ with:
+ path: ./site/public
+
+ # Deployment job
+ deploy:
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ runs-on: ubuntu-latest
+ needs: build
+ steps:
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..c2658d7
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+node_modules/
diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 0000000..80a9956
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+v20.16.0
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..824c817
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Model Context Protocol spec
+
+This repo contains the specification and protocol schema for the Model Context Protocol.
+
+The schema is [defined in TypeScript](schema/schema.ts) first, but [made available as JSON Schema](schema/schema.json) as well, for wider compatibility.
+
+## Prequisites
+
+The following software is required to work on the spec:
+
+ * Typescript
+ * Node.JS 20 or above
+ * Yarn
+ * Typescript JSON Schema (for generating json schema)
+ * Hugo (optionally, for serving the documentation)
+ * Go (optionall, for serving the documentation)
+ * nvm (optionally, for managing node versions)
+
+## Validating and building the spec
+The following commands install the dependencies, validate the schema and generate the json schema.
+
+```bash
+$ nvn install # install the correct node version
+$ yarn install # install dependencies
+$ yarn validate:schema # validate the schema
+$ yarn validate:examples # validate the examples
+$ yarn generate:json # generate the json schema
+```
+
+## Serving the documentation
+The documentation lives in the `docs` folder. To serve the documentation, run the following commands:
+
+```bash
+$ yarn serve:docs # serve the documentation
+```
+
+Note that this reqires Hugo and Go to be installed.
diff --git a/docs/guide/_index.md b/docs/guide/_index.md
new file mode 100644
index 0000000..f95eda9
--- /dev/null
+++ b/docs/guide/_index.md
@@ -0,0 +1,5 @@
+---
+title: Guide
+cascade:
+ type: docs
+---
diff --git a/docs/spec/_index.md b/docs/spec/_index.md
new file mode 100644
index 0000000..2802980
--- /dev/null
+++ b/docs/spec/_index.md
@@ -0,0 +1,171 @@
+---
+title: Model Cotext Protocol Specification
+cascade:
+ type: docs
+---
+
+_**NOTE:** This is a very early draft. Feel free to discuss changes, requirements, etc._
+
+# Goal
+The Model Context Protocol (MCP) is an attempt to allow implementors to provide context to various LLM surfaces such as editors/IDEs, [claude.ai](https://claude.ai), etc., in a pluggable way. It separates the concerns of providing context from the LLM loop and its usage within.
+
+This makes it **much** easier for anyone to script LLM applications for accomplishing their custom workflows, without the application needing to directly offer a large number of integrations.
+
+# Terminology
+The Model Context Protocol is inspired by Microsoft's [Language Server Protocol](https://microsoft.github.io/language-server-protocol/), with similar concepts:
+
+* **Server**: a process or service providing context via MCP.
+* **Client**: the initiator and client connection to a single MCP server. A message sent through a client is always directed to its one corresponding server.
+* **Host**: a process or service which runs any number of MCP clients. [For example, your editor might be a host, claude.ai might be a host, etc.](#example-hosts)
+* **Session**: a stateful session established between one client and server.
+* **Message**: a message refers to one of the following types of [JSON-RPC](https://www.jsonrpc.org/) object:
+ * **Request:** a request includes a `method` and `params`, and can be sent by either the server or the client, asking the other for some information or to perform some operation.
+ * **Response:** a response includes a `result` or an `error`, and is sent *back* after a request, once processing has finished (successfully or unsuccessfully).
+ * **Notification:** a special type of a request that does not expect a response, notifications are emitted by either the server or client to unilaterally inform the other of an event or state change.
+* **Capability**: a feature that the client or server supports. When an MCP connection is initiated, the client and server negotiate the capabilities that they both support, which affects the rest of the interaction.
+
+## Primitives
+On top of the base protocol, MCP introduces these unique primitives:
+
+* **Resources**: anything that can be loaded as context for an LLM. *Servers* expose a list of resources, identified with [URIs](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), which the *client* can choose to read or (if supported) subscribe to. Resources can be text or binary data—there are no restrictions on their content.
+* **Prompts**: prompts or prompt templates that the *server* can provide to the *client*, which the client can easily surface in the UI (e.g., as some sort of slash command).
+* **Tools**: functionality that the *client* can invoke on the *server*, to perform effectful operations. The client can choose to [expose these tools directly to the LLM](https://docs.anthropic.com/en/docs/build-with-claude/tool-use) too, allowing it to decide when and how to use them.
+* **Sampling**: *servers* can ask the *client* to sample from the LLM, which allows servers to implement agentic behaviors without having to implement sampling themselves. This also allows the client to combine the sampling request with *all of the other context it has*, making it much more intelligent—while avoiding needlessly exfiltrating information to servers.
+
+```mermaid
+flowchart LR
+ server["Server\nScript on local machine, web service, etc."]
+ host["Host (client)\nEditors, claude.ai, etc."]
+
+ host -->|"resource queries"| server
+ host -->|"invoke tools"| server
+ server -->|"sampling"| host
+ server -.->|"prompt templates"| host
+ server -.->|"resource contents"| host
+```
+
+## Control
+In addition to basic primitives, MCP offers a set of control flow messages.
+
+* **Logging:** Anything related to how the server processes logs.
+* **Completion**: Supports completion of server arguments on the client side. See
+
+# Use cases
+Most use cases are around enabling people to build their own specific workflows and integrations. MCP enables engineers and teams to **tailor AI to their needs.**
+
+The beauty of the Model Context Protocol is that it's **extremely composable**. You can imagine mixing and matching *any number* of the example servers below with any one of the hosts. Each individual server can be quite simple and limited, but *composed together*, you can get a super-powered AI!
+
+## Example servers
+* **File watcher**: read entire local directories, exposed as resources, and subscribe to changes. The server can provide a tool to write changes back to disk too!
+* **Screen watcher**: follow along with the user, taking screenshots automatically, and exposing those as resources. The host can use this to automatically attach screen captures to LLM context.
+* **Git integration**: could expose context like Git commit history, but probably *most* useful as a source of tools, like: "commit these changes," "merge this and resolve conflicts," etc.
+* **GitHub integration**: read and expose GitHub resources: files, commits, pull requests, issues, etc. Could also expose one or more tools to modify GitHub resources, like "create a PR."
+* **Asana integration**: similarly to GitHub—read/write Asana projects, tasks, etc.
+* **Slack integration**: read context from Slack channels. Could also look for specially tagged messages, or invocations of [shortcuts](https://api.slack.com/interactivity/shortcuts), as sources of context. Could expose tools to post messages to Slack.
+* **Google Workspace integration**: read and write emails, docs, etc.
+* **IDEs and editors**: IDEs and editors can be [servers](#example-hosts-clients) as well as hosts! As servers, they can be a rich source of context like: output/status of tests, [ASTs](https://en.wikipedia.org/wiki/Abstract_syntax_tree) and parse trees, and "which files are currently open and being edited?"
+
+A key design principle of MCP is that it should be *as simple as possible* to implement a server. We want anyone to be able to write, e.g., a local Python script of 100 or fewer lines and get a fully functioning server, with capabilities comparable to any of the above.
+
+## Example hosts
+* **IDEs and editors**: An MCP host inside an IDE or editor could support attaching any number of servers, which can be used to populate an in-editor LLM chat interface, as well as (e.g.) contextualize refactoring. In future, we could also imagine populating editors' command palette with all of the tools that MCP servers have made available.
+* **claude.ai**: [Claude.ai](https://claude.ai) can become an MCP host, allowing users to connect any number of MCP servers. Resources from those servers could be automatically made available for attaching to any Project or Chat. Claude could also make use of the tools exposed by MCP servers to implement agentic behaviors, saving artifacts to disk or to web services, etc.!
+* **Slack**: [Claude in Slack](https://www.anthropic.com/claude-in-slack) on steroids! Building an MCP host into Slack would open the door to much more complex interactions with LLMs via the platform—both in being able to read context from any number of places (for example, all the servers posited above), as well as being able to *take actions*, from Slack, via the tools that MCP servers expose.
+
+# Protocol
+## Initialization
+MCP [sessions](lifecycle) begin with an initialization phase, where the client and server identify each other, and exchange information about their respective [capabilities](lifecycle#capability-descriptions).
+
+The client can only begin requesting resources and invoking tools on the server, and the server can only begin requesting LLM sampling, after the client has issued the `initialized` notification:
+
+```mermaid
+sequenceDiagram
+ participant client as Client
+ participant server as Server
+
+ activate client
+ client -->>+ server: (connect over transport)
+ client -->> server: initialize
+ server -->> client: initialize_response
+ client --) server: initialized (notification)
+
+ loop while connected
+ alt client to server
+ client -->> server: request
+ server -->> client: response
+ else
+ client --) server: notification
+ else server to client
+ server -->> client: request
+ client -->> server: response
+ else
+ server --) client: notification
+ end
+ end
+
+ deactivate server
+ deactivate client
+```
+
+## Transports
+An MCP server or client must implement one of the following transports. Different transports require different clients (but each can run within the same *host*).
+
+### stdio
+The client spawns the server process and manages its lifetime, and writes messages to it on the server's stdin. The server writes messages back to the client on its stdout.
+
+Individual JSON-RPC messages are sent as newline-terminated JSON over the interface.
+
+Anything the server writes to stderr MAY be captured as logging, but the client is also allowed to ignore it completely.
+
+### SSE
+A client can open a [Server-Sent Events](https://en.wikipedia.org/wiki/Server-sent_events) connection to a server, which the server will use to push all of its requests and responses to the client.
+
+Upon connection, the server MUST issue a `endpoint` event (which is specific to MCP, not a default SSE event). The `data` associated with an `endpoint` event MUST be a URI for the client to use. The endpoint can be a relative or an absolute URI, but MUST always point to the same server origin. Cross-origin endpoints are not allowed, for security.
+
+The client MUST issue individual JSON-RPC messages through the endpoint identified by the server, using HTTP POST requests—this allows the server to link these out-of-band messages with the ongoing SSE stream.
+
+In turn, `message` events on the SSE stream will contain individual JSON-RPC messages from the server. The server MUST NOT send a `message` event until after the `endpoint` event has been issued.
+
+This sequence diagram shows the MCP initialization flow over SSE, followed by open-ended communication between client and server, until ultimately the client disconnects:
+
+```mermaid
+sequenceDiagram
+ participant client as MCP Client
+ participant server as MCP Server
+
+ activate client
+ client->>+server: new EventSource("https://server/mcp")
+ server->>client: event: endpoint
data: /session?id=8cfc516c-…
+
+ client-->>server: POST https://server/session?id=…
{InitializeRequest}
+ server->>client: event: message
data: {InitializeResponse}
+
+ client--)server: POST https://server/session?id=…
{InitializedNotification}
+
+ loop client requests and responses
+ client--)server: POST https://server/session?id=…
{…}
+ end
+
+ loop server requests and responses
+ server-)client: event: message
data: {…}
+ end
+
+ client -x server: EventSource.close()
+
+ deactivate server
+ deactivate client
+```
+
+## Security and T&S considerations
+This model, while making meaningful changes to productivity and product experience, is effectively a form of arbitrary data access and arbitrary code execution.
+
+**Every interaction between MCP host and server will need informed user consent.** For example:
+
+* Servers must only expose user data as [resources](resources) with the user's explicit consent. Hosts must not transmit that data elsewhere without the user's explicit consent.
+* Hosts must not invoke tools on servers without the user's explicit consent, and understanding of what the tool will do.
+* When a server initiates [sampling](sampling) via a host, the user must have control over:
+ * *Whether* sampling even occurs. (They may not want to be charged!)
+ * What the prompt that will actually be sampled is.
+ * *What the server sees* of the completion when sampling finishes.
+
+This latter point is why the sampling primitives do not permit MCP servers to see the whole prompt—instead, the host remains in control, and can censor or modify it at will.
diff --git a/docs/spec/jsonrpc.md b/docs/spec/jsonrpc.md
new file mode 100644
index 0000000..b773249
--- /dev/null
+++ b/docs/spec/jsonrpc.md
@@ -0,0 +1,79 @@
+---
+title: Base Protocol
+type: docs
+weight: 1
+---
+
+The Model Context Protocol (MCP) defines a set of JSON-RPC methods for communication between clients and servers in AI-assisted applications. MCP uses [JSON-RPC 2.0](https://www.jsonrpc.org/specification) as its base protocol.
+
+### Transport
+
+MCP client **SHOULD** use one of the following transport mechanisms, but are free to use alternative transports where applicable.:
+
+Standard Input/Output (STDIO)
+: Communication occurs through the standard input and output streams. JSON-RPC
+ messages are sent as individual lines over these streams. Each message is a
+ complete JSON object serialized as a single line of text, terminated by a
+ newline character. The client writes requests to the server's standard input
+ and reads responses from the server's standard output. See [transports](transports.md) for more details.
+
+HTTP with Server-Sent Events (SSE)
+: This transport uses HTTP (1.1 or above) as the underlying protocol. The client sends
+ requests to the server using standard HTTP POST requests with JSON-RPC
+ payloads. For server-to-client communication, Server-Sent Events (SSE) are
+ employed. The server keeps an open connection to the client and sends
+ messages as SSE events. See [transports](transports.md) for more details.
+
+### Message Format
+
+All messages in MCP **MUST** follow the [JSON-RPC 2.0](https://www.jsonrpc.org/specification) specification. The protocol defines three types of messages:
+
+1. Requests
+2. Responses
+3. Notifications
+
+#### Requests
+
+Requests are sent from the client to the server or vice versa. They **MUST** include a unique `id` and expect a response.
+
+#### Responses
+
+Responses are sent in reply to requests. They **MUST** include the same `id` as the corresponding request.
+
+#### Notifications
+
+Notifications are sent from the client to the server or vice versa. They do not expect a response and **MUST NOT** include an `id`.
+
+### Base Protocol
+
+The base protocol consists of the following JSON-RPC methods:
+
+- `initialize`: Sent from the client to the server to initialize the connection.
+- `initialized`: Sent from the client to the server after initialization is complete.
+- `ping`: Sent by either party to check if the other is still alive.
+
+Implementations **MUST** support these base protocol methods.
+
+### Model Context Protocol specific methods
+
+MCP defines methods based on JSON-RPC that clients and servers implement:
+
+- [Lifecycle](lifecycle.md) handling
+- [Resource](resources.md) management
+- [Prompt](prompts.md) handling
+- [Tool](tools.md) execution
+- [Logging](logging.md)
+- [Sampling](sampling.md)
+
+### Authentication
+
+Authentication mechanisms are not part of the core MCP specification. Implementations **MAY** provide authentication based on the transport they use..
+
+### Versioning
+
+The MCP version is declared in the `initialize` request and response. Clients and servers **MUST** agree on a compatible protocol version to proceed with communication.
+
+## Specification
+
+The conical specification can be found at [Model Context Protocol](http://github.com/modelcontextprotocol/spec/tree/main/spec/schema.ts). The specification of the data format
+is available in TypeScript (source of truth) and JSON Schema format (generated).
diff --git a/docs/spec/lifecycle.md b/docs/spec/lifecycle.md
new file mode 100644
index 0000000..6be76ec
--- /dev/null
+++ b/docs/spec/lifecycle.md
@@ -0,0 +1,205 @@
+---
+title: Lifecycle Management
+type: docs
+weight: 2
+---
+
+The Model Context Protocol defines a specific lifecycle for client-server interactions. This lifecycle consists of the following stages:
+
+Initialization
+: The client sends an `initialize` request to the server, initiating the connection.
+
+Capability Exchange
+: The client and server exchange information about their supported features and protocol versions.
+
+Normal Operation
+: After successful initialization, the client and server can freely communicate using the agreed-upon protocol.
+
+Shutdown
+: The connection is terminated, typically initiated by the client when it no longer needs the server's services.
+
+The initialization sequence in the Model Context Protocol follows these steps:
+
+```mermaid
+sequenceDiagram
+ participant Client
+ participant Server
+
+ Client->>Server: initialize request
+ Note over Client,Server: Includes protocol version, client capabilities
+ Server->>Client: InitializeResult
+ Note over Client,Server: Includes protocol version, server capabilities
+ Client->>Server: initialized notification
+ Note over Client,Server: Signals completion of initialization
+ rect rgb(200, 220, 240)
+ Note over Client,Server: Normal Operation
+ Client->>Server: Various requests (e.g., list resources, get prompts)
+ Server->>Client: Responses
+ Server->>Client: Requests (e.g., LLM sampling)
+ Client->>Server: Responses
+ end
+ Client->>Server: Shutdown (implementation-specific)
+```
+
+This sequence ensures that both parties are aware of each other's capabilities and agree on the protocol version to be used for further communication.
+
+
+# Details
+## Initialization
+The initialization process **MUST** begin with the client sending an `initialize` request to the server. This request **MUST** include:
+
+- The *protocol version* supported by the client as a numeric integer
+- The client's capabilities
+- Information about the client implementation
+
+{{}}
+ {{}}
+```typescript
+export interface InitializeRequest extends Request {
+ method: "initialize";
+ params: {
+ protocolVersion: number;
+ capabilities: ClientCapabilities;
+ clientInfo: Implementation;
+ };
+}
+```
+ {{}}
+ {{}}
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "method": "initialize",
+ "params": {
+ "protocolVersion": 1,
+ "capabilities": {
+ "experimental": {},
+ "sampling": {}
+ },
+ "clientInfo": {
+ "name": "ExampleClient",
+ "version": "1.0.0"
+ }
+ }
+}
+```
+ {{}}
+
+{{}}
+
+The server **MUST** respond to the initialize request with an `InitializeResult`. This response **MUST** include:
+
+- The *protocol version* the server will use
+- The server's capabilities
+- Information about the server implementation
+
+{{}}
+ {{}}
+ ```typescript
+ export interface InitializeResult extends Result {
+ protocolVersion: number;
+ capabilities: ServerCapabilities;
+ serverInfo: Implementation;
+ }
+ ```
+ {{}}
+ {{}}
+ ```json
+ {
+ "jsonrpc": "2.0",
+ "id": 1,
+ "result": {
+ "protocolVersion": 1,
+ "capabilities": {
+ "experimental": {},
+ "logging": {},
+ "prompts": {},
+ "resources": {
+ "subscribe": true
+ },
+ "tools": {}
+ },
+ "serverInfo": {
+ "name": "ExampleServer",
+ "version": "1.0.0"
+ }
+ }
+ }
+ ```
+ {{}}
+{{}}
+
+If the server cannot support the protocol version requested by the client, it **SHOULD** respond with an error.
+
+## Capability Exchange
+
+During the initialization process, both the client and server exchange their capabilities. This allows each party to understand what features and operations are supported by the other.
+
+The client's capabilities are sent in the `initialize` request:
+
+```typescript
+export interface ClientCapabilities {
+ experimental?: { [key: string]: object };
+ sampling?: {};
+}
+```
+
+The server's capabilities are sent in the `InitializeResult`:
+
+```typescript
+export interface ServerCapabilities {
+ experimental?: { [key: string]: object };
+ logging?: {};
+ prompts?: {};
+ resources?: {
+ subscribe?: boolean;
+ };
+ tools?: {};
+}
+```
+
+Both parties **SHOULD** respect the capabilities declared by the other and **SHOULD NOT** attempt to use features that are not supported.
+
+### Capability Descriptions
+
+Client Capabilities:
+- `experimental`: An object containing any experimental, non-standard capabilities supported by the client.
+- `sampling`: If present, indicates that the client supports sampling from an LLM.
+
+Server Capabilities:
+- `experimental`: An object containing any experimental, non-standard capabilities supported by the server.
+- `logging`: If present, indicates that the server supports controlling logging from client side.
+- `prompts`: If present, indicates that the server offers prompt templates.
+- `resources`: If present, indicates that the server offers resources to read. The `subscribe` property within this object indicates whether the server supports subscribing to resource updates.
+- `tools`: If present, indicates that the server offers tools to call.
+
+These capabilities allow the client and server to communicate their supported features, enabling them to adapt their behavior accordingly and utilize the full range of supported functionalities during their interaction.
+
+## Normal Operation
+
+After successful initialization, the client **MUST** send an `initialized` notification to the server:
+
+```typescript
+export interface InitializedNotification extends Notification {
+ method: "notifications/initialized";
+}
+```
+
+Once the server receives this notification, both client and server can begin normal operation. During this phase:
+
+1. The client **MAY** send requests to the server for various operations such as listing resources, getting prompts, or calling tools.
+2. The server **MAY** send requests to the client for operations like sampling from an LLM.
+3. Either party **MAY** send notifications to the other as needed.
+
+Both parties **MUST** be prepared to handle requests and notifications at any time during normal operation.
+
+## Shutdown
+
+The Model Context Protocol does not define a specific shutdown procedure. However, implementations **SHOULD** consider the following guidelines:
+
+1. The client **SHOULD** initiate the shutdown process when it no longer needs the server's services.
+2. The server **SHOULD** gracefully terminate any ongoing operations when a shutdown is initiated.
+3. Both parties **SHOULD** ensure that any resources are properly released during shutdown.
+
+Throughout all stages of the lifecycle, both client and server **MUST** adhere to the JSON-RPC 2.0 specification for message formatting and error handling.
diff --git a/docs/spec/prompts.md b/docs/spec/prompts.md
new file mode 100644
index 0000000..93b8a29
--- /dev/null
+++ b/docs/spec/prompts.md
@@ -0,0 +1,148 @@
+---
+title: Prompts
+type: docs
+weight: 3
+---
+
+The Prompts API allows clients to retrieve information about available prompts and prompt templates from the server.
+
+## Capabilities
+
+To indicate support for the Prompts API, server and client **MUST** agree on the `prompts` capability in their capabilities during initialization.
+
+## Request example
+
+```mermaid
+sequenceDiagram
+ participant Client
+ participant Server
+
+ Client->>Server: prompts/list
+ Server-->>Client: ListPromptsResult
+ Note over Client,Server: Client selects a prompt
+ Client->>Server: prompts/get
+ Server-->>Client: GetPromptResult
+```
+
+## List Prompts
+
+The client **SHOULD** send a `prompts/list` request to retrieve a list of available prompts and prompt templates from the server.
+
+### Request
+
+- method: "prompts/list"
+- params: none
+
+### Response
+
+The server **MUST** respond with a `ListPromptsResult` as defined in the TypeScript interface:
+
+```typescript
+export interface ListPromptsResult extends Result {
+ prompts: Prompt[];
+}
+```
+
+Each `Prompt` object in the `prompts` array **MUST** conform to the following TypeScript interface:
+
+```typescript
+export interface Prompt {
+ name: string;
+ description?: string;
+ arguments?: {
+ name: string;
+ description?: string;
+ required?: boolean;
+ }[];
+}
+```
+
+The server **MUST** include:
+
+- prompts: An array of `Prompt` objects describing the available prompts/templates
+
+Each `Prompt` object **MUST** contain:
+
+- name: A string identifying the prompt/template
+- description: An optional string describing the prompt (if provided)
+- arguments: An optional array of argument definitions (if the prompt is a template)
+
+Argument definitions, if present, **MUST** include:
+
+- name: The argument name
+- description: An optional description of the argument
+- required: An optional boolean indicating if the argument is required
+
+The server **SHOULD** provide descriptive names and descriptions to help clients understand the purpose and usage of each prompt or template.
+## Get Prompt
+
+To retrieve a specific prompt or instantiate a prompt template, the client **SHOULD** send a `prompts/get` request.
+
+### Request
+
+- method: "prompts/get"
+- params:
+ - name: The name of the prompt/template to retrieve
+ - arguments: An optional object containing argument values for templates
+
+### Response
+
+The server **MUST** respond with a `GetPromptResult` containing:
+
+- description: An optional string describing the prompt
+- messages: An array of `SamplingMessage` objects representing the prompt content
+
+Each `SamplingMessage` **MUST** have:
+
+- role: Either "user" or "assistant"
+- content: Either a text object or an image object
+
+Text content objects **MUST** contain:
+
+- type: "text"
+- text: The text content
+
+Image content objects **MUST** contain:
+
+- type: "image"
+- data: Base64-encoded image data
+- mimeType: The MIME type of the image
+
+Example response:
+
+```json
+{
+ "description": "A prompt for analyzing code quality",
+ "messages": [
+ {
+ "role": "user",
+ "content": {
+ "type": "text",
+ "text": "Please review the following code snippet and provide feedback on its quality and potential improvements:"
+ }
+ },
+ {
+ "role": "assistant",
+ "content": {
+ "type": "text",
+ "text": "Certainly! I'd be happy to review the code snippet and provide feedback on its quality and potential improvements. Please share the code you'd like me to analyze."
+ }
+ },
+ {
+ "role": "user",
+ "content": {
+ "type": "text",
+ "text": "{{code}}"
+ }
+ }
+ ]
+}
+```
+
+In this example, `{{code}}` is a placeholder that would be replaced with the actual code snippet when the prompt is used.
+
+## Capabilities
+
+To indicate support for the Prompts API, servers **MUST** include a `prompts` capability in their `ServerCapabilities` during initialization.
+
+Clients **SHOULD** check for this capability before using the Prompts API.
diff --git a/examples/completion.md b/examples/completion.md
new file mode 100644
index 0000000..c2d71af
--- /dev/null
+++ b/examples/completion.md
@@ -0,0 +1,111 @@
+# Completion API
+The completion API provides ability for clients to request a
+set of completion options for a prompt argument or a resource template
+argument.
+
+## Basic Completion: completion/complete
+The RPC method `completion/complete` is used for basic completion
+tasks. They reference either a prompt or a uri template.
+
+### Client Requests
+#### Reference Example 1
+
+The following example references a prompt with the name "weather-forecast".
+
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "method": "completion/complete",
+ "params": {
+ "ref": {
+ "type": "ref/prompt",
+ "name": "weather-forecast"
+ },
+ "argument": {
+ "name": "location",
+ "value": "New"
+ }
+ }
+}
+```
+
+#### Reference Example 2
+
+The alternative is to reference a URI template of a resource:
+
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "method": "completion/complete",
+ "params": {
+ "ref": {
+ "type": "ref/resource",
+ "uri": "file://64e56d89-ba43-4664-87fc-ff6703527e3b/?as={mimeType}"
+ },
+ "argument": {
+ "name": "mimeType",
+ "value": ""
+ }
+ }
+}
+```
+
+### Server Responses
+
+Responses can only contain up to 100 elements. The server should
+notify the client how many elements are there in total. If the
+server knows the *exact* amount, it should specifiy the amount in
+`total` as an `integer`. If the server does not know how many left,
+but knows there are more completions than returned, `total` should
+be set to `hasMore`. This can be useful when the server wants to
+make efficient database queries and limit the resultset. In cases
+where the server does not know if there are any left, for example
+when reading from a service that does not provide such information,
+it can set `total` to `unknown`. This should be avoided if possible.
+
+#### Example Response with known total
+
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "result": {
+ "completion": {
+ "values": [
+ "New York",
+ "New Orleans",
+ "New Delhi",
+ "New Haven",
+ "New Jersey"
+ ],
+ "total": 5
+ }
+ }
+}
+```
+
+#### Example Response with unknown total
+The following case illustrates the case where the total
+is unknown, but the server knows there are more elements
+than returned:
+
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "result": {
+ "completion": {
+ "values": [
+ "New York",
+ "New Orleans",
+ "New Delhi",
+ "New Haven",
+ "New Jersey"
+ ],
+ "hasMore": true
+ }
+ }
+}
+```
diff --git a/examples/prompts.md b/examples/prompts.md
new file mode 100644
index 0000000..30594d9
--- /dev/null
+++ b/examples/prompts.md
@@ -0,0 +1,77 @@
+# Prompt API
+The Prompt API provides a set of prompts with optional
+arguments and [autocompletion](completion.md) support.
+
+## Listing Prompts
+The client can request a set of prompts
+from the server using the `prompts/list` call
+
+A client request:
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "method": "prompts/list",
+ "params": {}
+}
+```
+
+And an appropriate server response
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 1,
+ "result": {
+ "prompts": [
+ {
+ "name": "my-prompt",
+ "arguments": [
+ {
+ "name": "input",
+ "description": "The input string",
+ "required": false
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## Running a prompt
+In order to run a prompt, the client issues
+a `prompts/get` command:
+
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 2,
+ "method": "prompts/get",
+ "params": {
+ "name": "my-prompt",
+ "arguments": {
+ "input": "hello world"
+ }
+ }
+}
+```
+
+and it's respective response:
+```json
+{
+ "jsonrpc": "2.0",
+ "id": 2,
+ "result": {
+ "description": "An optional description of the prompt.",
+ "messages": [
+ {
+ "role": "user",
+ "content": {
+ "type": "text",
+ "text": "This is a templated prompt. You passed the argument 'hello world'"
+ }
+ }
+ ]
+ }
+}
+```
diff --git a/examples/workflow_diagrams.md b/examples/workflow_diagrams.md
new file mode 100644
index 0000000..e0731f6
--- /dev/null
+++ b/examples/workflow_diagrams.md
@@ -0,0 +1,170 @@
+# Example MCP workflow diagrams
+
+Some illustrative sequence diagrams of various concepts that could be built as MCP servers.
+
+**NOTE:** These are _examples_, not necessarily planned integrations!
+
+### Google Drive Resource Requests
+
+> a sequence diagram showing how resources would be requested from a Google Drive MCP server
+
+```mermaid
+sequenceDiagram
+ participant Client as MCP Client
+ participant Server as Google Drive MCP Server
+ participant GDrive as Google Drive API
+
+ Client->>+Server: initialize
+ Server-->>-Client: InitializeResult
+ Client->>Server: initialized
+
+ Client->>+Server: resources/list
+ Server->>+GDrive: List files and folders
+ GDrive-->>-Server: Files and folders list
+ Server-->>-Client: ListResourcesResult
+
+ Client->>+Server: resources/read (file.txt)
+ Server->>+GDrive: Get file contents
+ GDrive-->>-Server: File contents
+ Server-->>-Client: ReadResourceResult
+
+ opt Subscribe to folder updates
+ Client->>+Server: resources/subscribe (folder/)
+ Server-->>-Client: EmptyResult
+
+ loop While subscribed
+ GDrive-->>Server: File change notification
+ Server->>Client: notifications/resources/updated (folder/newfile.txt)
+
+ opt Read updated resource
+ Client->>+Server: resources/read (folder/newfile.txt)
+ Server->>+GDrive: Get file contents
+ GDrive-->>-Server: File contents
+ Server-->>-Client: ReadResourceResult
+ end
+ end
+
+ Client->>+Server: resources/unsubscribe (folder/)
+ Server-->>-Client: EmptyResult
+ end
+```
+
+### Git MCP Server Tool Use
+
+> an example of a Git MCP server, exposing a few Git commands as tool use for the LLM
+
+```mermaid
+sequenceDiagram
+ participant User
+ participant LLM
+ participant MCP Client
+ participant MCP Server
+ participant Git System as Git
+
+ User->>LLM: "Commit my changes and push"
+
+ LLM->>MCP Client: Request available tools
+ MCP Client->>MCP Server: tools/list
+ MCP Server-->>MCP Client: ListToolsResult (Git commands)
+ MCP Client-->>LLM: Available Git tools
+
+ LLM->>MCP Client: tools/call (git status)
+ MCP Client->>MCP Server: tools/call (git status)
+ MCP Server->>Git System: git status
+ Git System-->>MCP Server: status output
+ MCP Server-->>MCP Client: CallToolResult (status)
+ MCP Client-->>LLM: Git status result
+
+ Note over LLM: LLM analyzes status, decides to commit
+
+ LLM->>MCP Client: tools/call (git commit -m "Update files")
+ MCP Client->>MCP Server: tools/call (git commit -m "Update files")
+ MCP Server->>Git System: git commit -m "Update files"
+ Git System-->>MCP Server: commit result
+ MCP Server-->>MCP Client: CallToolResult (commit)
+ MCP Client-->>LLM: Commit result
+
+ LLM->>MCP Client: tools/call (git push)
+ MCP Client->>MCP Server: tools/call (git push)
+ MCP Server->>Git System: git push
+ Git System-->>MCP Server: push result
+ MCP Server-->>MCP Client: CallToolResult (push)
+ MCP Client-->>LLM: Push result
+
+ LLM->>User: "I've committed and pushed your changes!"
+```
+
+### Code Review Prompts
+
+> … a code review assistant … could offer a set of specialized prompts to help developers conduct more thorough and efficient code reviews.
+
+```mermaid
+sequenceDiagram
+ participant C as Client (e.g., IDE)
+ participant S as Code Review Prompts MCP Server
+
+ C->>S: initialize
+ S-->>C: InitializeResult (capabilities, etc.)
+ C->>S: initialized
+ C->>S: prompts/list
+ S-->>C: ListPromptsResult (available prompts)
+
+ Note over C: User selects "security-review" prompt
+
+ C->>S: prompts/get (name: "security-review", arguments)
+ S-->>C: GetPromptResult (messages for security review)
+
+ Note over C: User selects "performance-review" prompt
+
+ C->>S: prompts/get (name: "performance-review", arguments)
+ S-->>C: GetPromptResult (messages for performance review)
+
+ Note over C: User selects "code-style-review" prompt
+
+ C->>S: prompts/get (name: "code-style-review", arguments)
+ S-->>C: GetPromptResult (messages for style review)
+```
+
+### GitHub PR Summaries Server
+
+> an MCP server that summarizes GitHub pull requests
+>
+> …
+>
+>
+> 1. MCP server loads all the PRs on a GitHub repo
+> 2. MCP server requests LLM sampling to summarize each one
+> 3. The summaries are vended as MCP resources
+
+```mermaid
+sequenceDiagram
+ participant Client
+ participant MCP Server
+ participant GitHub API
+ participant LLM
+
+ Client->>MCP Server: initialize
+ MCP Server->>Client: initialize_response
+ Client->>MCP Server: initialized
+
+ MCP Server->>GitHub API: Fetch all PRs
+ GitHub API->>MCP Server: PR details
+
+ loop For each PR
+ MCP Server->>Client: sampling/createMessage (PR summary prompt)
+ Client->>LLM: Sample
+ LLM->>Client: Generated summary
+ Client->>MCP Server: CreateMessageResult (PR summary)
+ Note over MCP Server: Store summary as resource
+ end
+
+ Note over Client: Some time later...
+
+ Client->>MCP Server: resources/list
+ MCP Server->>Client: ListResourcesResult (PR summary URIs)
+
+ Client->>MCP Server: resources/read (PR summary URI)
+ MCP Server->>Client: ReadResourceResult (PR summary)
+
+ Note over Client,MCP Server: Client can request more summaries as needed
+```
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..fc5f049
--- /dev/null
+++ b/package.json
@@ -0,0 +1,25 @@
+{
+ "name": "mcp-spec",
+ "version": "0.1.0",
+ "private": true,
+ "engines": {
+ "node": ">=20"
+ },
+ "scripts": {
+ "validate:schema": "tsc --noEmit schema/schema.ts",
+ "validate:examples": "tsx scripts/validate_examples.ts",
+ "generate:json": "typescript-json-schema --defaultNumberType integer --required schema/schema.ts \"*\" -o schema/schema.json",
+ "serve:docs": "cd site/ && hugo server --logLevel debug --disableFastRender"
+ },
+ "devDependencies": {
+ "ajv": "^8.17.1",
+ "ajv-formats": "^3.0.1",
+ "glob": "^11.0.0",
+ "tsx": "^4.19.1",
+ "typescript": "^5.6.2",
+ "typescript-json-schema": "^0.65.1"
+ },
+ "resolutions": {
+ "fast-json-patch": "^3.1.1"
+ }
+}
diff --git a/schema/schema.json b/schema/schema.json
new file mode 100644
index 0000000..c4dc468
--- /dev/null
+++ b/schema/schema.json
@@ -0,0 +1,1564 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "description": "A base64-encoded string representing the binary data of the item.",
+ "format": "byte",
+ "type": "string"
+ },
+ "mimeType": {
+ "description": "The MIME type of this resource, if known.",
+ "type": "string"
+ },
+ "uri": {
+ "description": "The URI of this resource.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "CallToolRequest": {
+ "description": "Used by the client to invoke a tool provided by the server.",
+ "properties": {
+ "method": {
+ "const": "tools/call",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "arguments": {
+ "additionalProperties": {},
+ "type": "object"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "toolResult": {}
+ },
+ "required": [
+ "toolResult"
+ ],
+ "type": "object"
+ },
+ "ClientCapabilities": {
+ "description": "Capabilities a client may support. Known capabilities are defined here, in this schema, but this is not a closed set: any client can define its own, additional capabilities.",
+ "properties": {
+ "experimental": {
+ "additionalProperties": {
+ "additionalProperties": true,
+ "properties": {},
+ "type": "object"
+ },
+ "description": "Experimental, non-standard capabilities that the client supports.",
+ "type": "object"
+ },
+ "sampling": {
+ "additionalProperties": true,
+ "description": "Present if the client supports sampling from an LLM.",
+ "properties": {},
+ "type": "object"
+ }
+ },
+ "type": "object"
+ },
+ "ClientNotification": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/InitializedNotification"
+ },
+ {
+ "$ref": "#/definitions/ProgressNotification"
+ }
+ ]
+ },
+ "ClientRequest": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/InitializeRequest"
+ },
+ {
+ "$ref": "#/definitions/PingRequest"
+ },
+ {
+ "$ref": "#/definitions/ListResourcesRequest"
+ },
+ {
+ "$ref": "#/definitions/ReadResourceRequest"
+ },
+ {
+ "$ref": "#/definitions/SubscribeRequest"
+ },
+ {
+ "$ref": "#/definitions/UnsubscribeRequest"
+ },
+ {
+ "$ref": "#/definitions/ListPromptsRequest"
+ },
+ {
+ "$ref": "#/definitions/GetPromptRequest"
+ },
+ {
+ "$ref": "#/definitions/ListToolsRequest"
+ },
+ {
+ "$ref": "#/definitions/CallToolRequest"
+ },
+ {
+ "$ref": "#/definitions/SetLevelRequest"
+ },
+ {
+ "$ref": "#/definitions/CompleteRequest"
+ }
+ ]
+ },
+ "ClientResult": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Result"
+ },
+ {
+ "$ref": "#/definitions/CreateMessageResult"
+ }
+ ]
+ },
+ "CompleteRequest": {
+ "description": "A request from the client to the server, to ask for completion options.",
+ "properties": {
+ "method": {
+ "const": "completion/complete",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "argument": {
+ "description": "The argument's information",
+ "properties": {
+ "name": {
+ "description": "The name of the argument",
+ "type": "string"
+ },
+ "value": {
+ "description": "The value of the argument to use for completion matching.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "value"
+ ],
+ "type": "object"
+ },
+ "ref": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PromptReference"
+ },
+ {
+ "$ref": "#/definitions/ResourceReference"
+ }
+ ]
+ }
+ },
+ "required": [
+ "argument",
+ "ref"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "CompleteResult": {
+ "description": "The server's response to a completion/complete request",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "completion": {
+ "properties": {
+ "hasMore": {
+ "description": "Indicates whether there are additional completion options beyond those provided in the current response, even if the exact total is unknown.",
+ "type": "boolean"
+ },
+ "total": {
+ "description": "The total number of completion options available. This can exceed the number of values actually sent in the response.",
+ "type": "integer"
+ },
+ "values": {
+ "description": "An array of completion values. Must not exceed 100 items.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "values"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "completion"
+ ],
+ "type": "object"
+ },
+ "CreateMessageRequest": {
+ "description": "A request from the server to sample an LLM via the client. The client has full discretion over which model to select. The client should also inform the user before beginning sampling, to allow them to inspect the request (human in the loop) and decide whether to approve it.",
+ "properties": {
+ "method": {
+ "const": "sampling/createMessage",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "includeContext": {
+ "description": "A request to include context from one or more MCP servers (including the caller), to be attached to the prompt. The client MAY ignore this request.",
+ "enum": [
+ "allServers",
+ "none",
+ "thisServer"
+ ],
+ "type": "string"
+ },
+ "maxTokens": {
+ "description": "The maximum number of tokens to sample, as requested by the server. The client MAY choose to sample fewer tokens than requested.",
+ "type": "integer"
+ },
+ "messages": {
+ "items": {
+ "$ref": "#/definitions/SamplingMessage"
+ },
+ "type": "array"
+ },
+ "metadata": {
+ "additionalProperties": true,
+ "description": "Optional metadata to pass through to the LLM provider. The format of this metadata is provider-specific.",
+ "properties": {},
+ "type": "object"
+ },
+ "stopSequences": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "systemPrompt": {
+ "description": "An optional system prompt the server wants to use for sampling. The client MAY modify or omit this prompt.",
+ "type": "string"
+ },
+ "temperature": {
+ "type": "number"
+ }
+ },
+ "required": [
+ "maxTokens",
+ "messages"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "CreateMessageResult": {
+ "description": "The client's response to a sampling/create_message request from the server. The client should inform the user before returning the sampled message, to allow them to inspect the response (human in the loop) and decide whether to allow the server to see it.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "content": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ }
+ ]
+ },
+ "model": {
+ "description": "The name of the model that generated the message.",
+ "type": "string"
+ },
+ "role": {
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "stopReason": {
+ "description": "The reason why sampling stopped.",
+ "enum": [
+ "endTurn",
+ "maxTokens",
+ "stopSequence"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "model",
+ "role",
+ "stopReason"
+ ],
+ "type": "object"
+ },
+ "EmptyResult": {
+ "$ref": "#/definitions/Result"
+ },
+ "GetPromptRequest": {
+ "description": "Used by the client to get a prompt provided by the server.",
+ "properties": {
+ "method": {
+ "const": "prompts/get",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "arguments": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "Arguments to use for templating the prompt.",
+ "type": "object"
+ },
+ "name": {
+ "description": "The name of the prompt or prompt template.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "GetPromptResult": {
+ "description": "The server's response to a prompts/get request from the client.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "description": {
+ "description": "An optional description for the prompt.",
+ "type": "string"
+ },
+ "messages": {
+ "items": {
+ "$ref": "#/definitions/SamplingMessage"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "messages"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "data": {
+ "description": "The base64-encoded image data.",
+ "format": "byte",
+ "type": "string"
+ },
+ "mimeType": {
+ "description": "The MIME type of the image. Different providers may support different image types.",
+ "type": "string"
+ },
+ "type": {
+ "const": "image",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "Implementation": {
+ "description": "Describes the name and version of an MCP implementation.",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "InitializeRequest": {
+ "description": "This request is sent from the client to the server when it first connects, asking it to begin initialization.",
+ "properties": {
+ "method": {
+ "const": "initialize",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "capabilities": {
+ "$ref": "#/definitions/ClientCapabilities"
+ },
+ "clientInfo": {
+ "$ref": "#/definitions/Implementation"
+ },
+ "protocolVersion": {
+ "const": 1,
+ "description": "The latest version of the Model Context Protocol that the client supports. The client MAY decide to support older versions as well.",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "capabilities",
+ "clientInfo",
+ "protocolVersion"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "InitializeResult": {
+ "description": "After receiving an initialize request from the client, the server sends this response.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "capabilities": {
+ "$ref": "#/definitions/ServerCapabilities"
+ },
+ "protocolVersion": {
+ "const": 1,
+ "description": "The version of the Model Context Protocol that the server wants to use. This may not match the version that the client requested. If the client cannot support this version, it MUST disconnect.",
+ "type": "integer"
+ },
+ "serverInfo": {
+ "$ref": "#/definitions/Implementation"
+ }
+ },
+ "required": [
+ "capabilities",
+ "protocolVersion",
+ "serverInfo"
+ ],
+ "type": "object"
+ },
+ "InitializedNotification": {
+ "description": "This notification is sent from the client to the server after initialization has finished.",
+ "properties": {
+ "method": {
+ "const": "notifications/initialized",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This parameter name is reserved by MCP to allow clients and servers to attach additional metadata to their notifications.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "JSONRPCError": {
+ "description": "A response to a request that indicates an error occurred.",
+ "properties": {
+ "error": {
+ "properties": {
+ "code": {
+ "description": "The error type that occurred.",
+ "type": "integer"
+ },
+ "data": {
+ "description": "Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.)."
+ },
+ "message": {
+ "description": "A short description of the error. The message SHOULD be limited to a concise single sentence.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "jsonrpc": {
+ "const": "2.0",
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "id",
+ "jsonrpc"
+ ],
+ "type": "object"
+ },
+ "JSONRPCMessage": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/JSONRPCRequest"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCNotification"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCResponse"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCError"
+ }
+ ]
+ },
+ "JSONRPCNotification": {
+ "description": "A notification which does not expect a response.",
+ "properties": {
+ "jsonrpc": {
+ "const": "2.0",
+ "type": "string"
+ },
+ "method": {
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This parameter name is reserved by MCP to allow clients and servers to attach additional metadata to their notifications.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "jsonrpc",
+ "method"
+ ],
+ "type": "object"
+ },
+ "JSONRPCRequest": {
+ "description": "A request that expects a response.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "jsonrpc": {
+ "const": "2.0",
+ "type": "string"
+ },
+ "method": {
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "properties": {
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "id",
+ "jsonrpc",
+ "method"
+ ],
+ "type": "object"
+ },
+ "JSONRPCResponse": {
+ "description": "A successful (non-error) response to a request.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "jsonrpc": {
+ "const": "2.0",
+ "type": "string"
+ },
+ "result": {
+ "$ref": "#/definitions/Result"
+ }
+ },
+ "required": [
+ "id",
+ "jsonrpc",
+ "result"
+ ],
+ "type": "object"
+ },
+ "ListPromptsRequest": {
+ "description": "Sent from the client to request a list of prompts and prompt templates the server has.",
+ "properties": {
+ "method": {
+ "const": "prompts/list",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "properties": {
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "ListPromptsResult": {
+ "description": "The server's response to a prompts/list request from the client.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "prompts": {
+ "items": {
+ "$ref": "#/definitions/Prompt"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "prompts"
+ ],
+ "type": "object"
+ },
+ "ListResourcesRequest": {
+ "description": "Sent from the client to request a list of resources the server has.",
+ "properties": {
+ "method": {
+ "const": "resources/list",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "properties": {
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "ListResourcesResult": {
+ "description": "The server's response to a resources/list request from the client.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "resourceTemplates": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "resources": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "ListToolsRequest": {
+ "description": "Sent from the client to request a list of tools the server has.",
+ "properties": {
+ "method": {
+ "const": "tools/list",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "properties": {
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "ListToolsResult": {
+ "description": "The server's response to a tools/list request from the client.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/Tool"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "LoggingLevel": {
+ "description": "The severity of a log message.",
+ "enum": [
+ "debug",
+ "error",
+ "info",
+ "warning"
+ ],
+ "type": "string"
+ },
+ "LoggingMessageNotification": {
+ "description": "Notification of a log message passed from server to client. If no logging/setLevel request has been sent from the client, the server MAY decide which messages to send automatically.",
+ "properties": {
+ "method": {
+ "const": "notifications/message",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "data": {
+ "description": "The data to be logged, such as a string message or an object. Any JSON serializable type is allowed here."
+ },
+ "level": {
+ "$ref": "#/definitions/LoggingLevel",
+ "description": "The severity of this log message."
+ },
+ "logger": {
+ "description": "An optional name of the logger issuing this message.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "level"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "Notification": {
+ "properties": {
+ "method": {
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This parameter name is reserved by MCP to allow clients and servers to attach additional metadata to their notifications.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "PingRequest": {
+ "description": "A ping, issued by either the server or the client, to check that the other party is still alive. The receiver must promptly respond, or else may be disconnected.",
+ "properties": {
+ "method": {
+ "const": "ping",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "properties": {
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "ProgressNotification": {
+ "description": "An out-of-band notification used to inform the receiver of a progress update for a long-running request.",
+ "properties": {
+ "method": {
+ "const": "notifications/progress",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "progress": {
+ "description": "The progress thus far. This should increase every time progress is made, even if the total is unknown.",
+ "type": "number"
+ },
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "The progress token which was given in the initial request, used to associate this notification with the request that is proceeding."
+ },
+ "total": {
+ "description": "Total number of items to process (or total progress required), if known.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "progress",
+ "progressToken"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "ProgressToken": {
+ "description": "A progress token, used to associate progress notifications with the original request.",
+ "type": [
+ "string",
+ "integer"
+ ]
+ },
+ "Prompt": {
+ "description": "A prompt or prompt template that the server offers.",
+ "properties": {
+ "arguments": {
+ "description": "A list of arguments to use for templating the prompt.",
+ "items": {
+ "$ref": "#/definitions/PromptArgument"
+ },
+ "type": "array"
+ },
+ "description": {
+ "description": "An optional description of what this prompt provides",
+ "type": "string"
+ },
+ "name": {
+ "description": "The name of the prompt or prompt template.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "PromptArgument": {
+ "description": "Describes an argument that a prompt can accept.",
+ "properties": {
+ "description": {
+ "description": "A human-readable description of the argument.",
+ "type": "string"
+ },
+ "name": {
+ "description": "The name of the argument.",
+ "type": "string"
+ },
+ "required": {
+ "description": "Whether this argument must be provided.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "PromptReference": {
+ "description": "Identifies a prompt.",
+ "properties": {
+ "name": {
+ "description": "The name of the prompt or prompt template",
+ "type": "string"
+ },
+ "type": {
+ "const": "ref/prompt",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type"
+ ],
+ "type": "object"
+ },
+ "ReadResourceRequest": {
+ "description": "Sent from the client to the server, to read a specific resource URI.",
+ "properties": {
+ "method": {
+ "const": "resources/read",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "uri": {
+ "description": "The URI of the resource to read. The URI can use any protocol; it is up to the server how to interpret it.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uri"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "ReadResourceResult": {
+ "description": "The server's response to a resources/read request from the client.",
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ },
+ "contents": {
+ "items": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "contents"
+ ],
+ "type": "object"
+ },
+ "Request": {
+ "properties": {
+ "method": {
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "properties": {
+ "progressToken": {
+ "$ref": "#/definitions/ProgressToken",
+ "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
+ }
+ },
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "RequestId": {
+ "description": "A uniquely identifying ID for a request in JSON-RPC.",
+ "type": [
+ "string",
+ "integer"
+ ]
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "mimeType": {
+ "description": "The MIME type of this resource, if known.",
+ "type": "string"
+ },
+ "uri": {
+ "description": "The URI of this resource.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceContents": {
+ "description": "The contents of a specific resource or sub-resource.",
+ "properties": {
+ "mimeType": {
+ "description": "The MIME type of this resource, if known.",
+ "type": "string"
+ },
+ "uri": {
+ "description": "The URI of this resource.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceListChangedNotification": {
+ "description": "An optional notification from the server to the client, informing it that the list of resources it can read from has changed. This may be issued by servers without any previous subscription from the client.",
+ "properties": {
+ "method": {
+ "const": "notifications/resources/list_changed",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This parameter name is reserved by MCP to allow clients and servers to attach additional metadata to their notifications.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "ResourceReference": {
+ "description": "A reference to a resource or resource template definition.",
+ "properties": {
+ "type": {
+ "const": "ref/resource",
+ "type": "string"
+ },
+ "uri": {
+ "description": "The URI or URI template of the resource.",
+ "format": "uri-template",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "description": {
+ "description": "A human-readable description of what this template is for.",
+ "type": "string"
+ },
+ "mimeType": {
+ "description": "The MIME type for all resources that match this template. This should only be included if all resources matching this template have the same type.",
+ "type": "string"
+ },
+ "name": {
+ "description": "A human-readable name for the type of resource this template refers to.",
+ "type": "string"
+ },
+ "uriTemplate": {
+ "description": "A URI template (according to RFC 6570) that can be used to construct resource URIs.",
+ "format": "uri-template",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResourceUpdatedNotification": {
+ "description": "A notification from the server to the client, informing it that a resource has changed and may need to be read again. This should only be sent if the client previously sent a resources/subscribe request.",
+ "properties": {
+ "method": {
+ "const": "notifications/resources/updated",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "uri": {
+ "description": "The URI of the resource that has been updated. This might be a sub-resource of the one that the client actually subscribed to.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uri"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "Result": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ },
+ "SamplingMessage": {
+ "description": "Describes a message issued to or received from an LLM API.",
+ "properties": {
+ "content": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ }
+ ]
+ },
+ "role": {
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role"
+ ],
+ "type": "object"
+ },
+ "ServerCapabilities": {
+ "description": "Capabilities that a server may support. Known capabilities are defined here, in this schema, but this is not a closed set: any server can define its own, additional capabilities.",
+ "properties": {
+ "experimental": {
+ "additionalProperties": {
+ "additionalProperties": true,
+ "properties": {},
+ "type": "object"
+ },
+ "description": "Experimental, non-standard capabilities that the server supports.",
+ "type": "object"
+ },
+ "logging": {
+ "additionalProperties": true,
+ "description": "Present if the server supports sending log messages to the client.",
+ "properties": {},
+ "type": "object"
+ },
+ "prompts": {
+ "additionalProperties": true,
+ "description": "Present if the server offers any prompt templates.",
+ "properties": {},
+ "type": "object"
+ },
+ "resources": {
+ "description": "Present if the server offers any resources to read.",
+ "properties": {
+ "subscribe": {
+ "description": "Whether this server supports subscribing to resource updates.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": true,
+ "description": "Present if the server offers any tools to call.",
+ "properties": {},
+ "type": "object"
+ }
+ },
+ "type": "object"
+ },
+ "ServerNotification": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ProgressNotification"
+ },
+ {
+ "$ref": "#/definitions/ResourceListChangedNotification"
+ },
+ {
+ "$ref": "#/definitions/ResourceUpdatedNotification"
+ },
+ {
+ "$ref": "#/definitions/ToolListChangedNotification"
+ },
+ {
+ "$ref": "#/definitions/LoggingMessageNotification"
+ }
+ ]
+ },
+ "ServerRequest": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PingRequest"
+ },
+ {
+ "$ref": "#/definitions/CreateMessageRequest"
+ }
+ ]
+ },
+ "ServerResult": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Result"
+ },
+ {
+ "$ref": "#/definitions/InitializeResult"
+ },
+ {
+ "$ref": "#/definitions/ListResourcesResult"
+ },
+ {
+ "$ref": "#/definitions/ReadResourceResult"
+ },
+ {
+ "$ref": "#/definitions/ListPromptsResult"
+ },
+ {
+ "$ref": "#/definitions/GetPromptResult"
+ },
+ {
+ "$ref": "#/definitions/ListToolsResult"
+ },
+ {
+ "$ref": "#/definitions/CallToolResult"
+ },
+ {
+ "$ref": "#/definitions/CompleteResult"
+ }
+ ]
+ },
+ "SetLevelRequest": {
+ "description": "A request from the client to the server, to enable or adjust logging.",
+ "properties": {
+ "method": {
+ "const": "logging/setLevel",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "level": {
+ "$ref": "#/definitions/LoggingLevel",
+ "description": "The level of logging that the client wants to receive from the server. The server should send all logs at this level and higher (i.e., more severe) to the client as notifications/logging/message."
+ }
+ },
+ "required": [
+ "level"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "SubscribeRequest": {
+ "description": "Sent from the client to request resources/updated notifications from the server whenever a particular resource changes.",
+ "properties": {
+ "method": {
+ "const": "resources/subscribe",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "uri": {
+ "description": "The URI of the resource to subscribe to. The URI can use any protocol; it is up to the server how to interpret it.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uri"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "text": {
+ "description": "The text content of the message.",
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "description": "The MIME type of this resource, if known.",
+ "type": "string"
+ },
+ "text": {
+ "description": "The text of the item. This must only be set if the item can actually be represented as text (not binary data).",
+ "type": "string"
+ },
+ "uri": {
+ "description": "The URI of this resource.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "description": {
+ "description": "A human-readable description of the tool.",
+ "type": "string"
+ },
+ "inputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": {
+ "additionalProperties": {
+ "additionalProperties": true,
+ "properties": {},
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "type": {
+ "const": "object",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ "name": {
+ "description": "The name of the tool.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolListChangedNotification": {
+ "description": "An optional notification from the server to the client, informing it that the list of tools it offers has changed. This may be issued by servers without any previous subscription from the client.",
+ "properties": {
+ "method": {
+ "const": "notifications/tools/list_changed",
+ "type": "string"
+ },
+ "params": {
+ "additionalProperties": {},
+ "properties": {
+ "_meta": {
+ "additionalProperties": {},
+ "description": "This parameter name is reserved by MCP to allow clients and servers to attach additional metadata to their notifications.",
+ "type": "object"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "UnsubscribeRequest": {
+ "description": "Sent from the client to request cancellation of resources/updated notifications from the server. This should follow a previous resources/subscribe request.",
+ "properties": {
+ "method": {
+ "const": "resources/unsubscribe",
+ "type": "string"
+ },
+ "params": {
+ "properties": {
+ "uri": {
+ "description": "The URI of the resource to unsubscribe from.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "uri"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "type": "object"
+ }
+ }
+}
+
diff --git a/schema/schema.ts b/schema/schema.ts
new file mode 100644
index 0000000..a6ee018
--- /dev/null
+++ b/schema/schema.ts
@@ -0,0 +1,763 @@
+/* JSON-RPC types */
+export type JSONRPCMessage =
+ | JSONRPCRequest
+ | JSONRPCNotification
+ | JSONRPCResponse
+ | JSONRPCError;
+
+export const JSONRPC_VERSION = "2.0";
+
+/**
+ * A progress token, used to associate progress notifications with the original request.
+ */
+export type ProgressToken = string | number;
+
+export interface Request {
+ method: string;
+ params?: {
+ _meta?: {
+ /**
+ * If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications.
+ */
+ progressToken?: ProgressToken;
+ };
+ [key: string]: unknown;
+ };
+}
+
+export interface Notification {
+ method: string;
+ params?: {
+ /**
+ * This parameter name is reserved by MCP to allow clients and servers to attach additional metadata to their notifications.
+ */
+ _meta?: { [key: string]: unknown };
+ [key: string]: unknown;
+ };
+}
+
+export interface Result {
+ /**
+ * This result property is reserved by the protocol to allow clients and servers to attach additional metadata to their responses.
+ */
+ _meta?: { [key: string]: unknown };
+ [key: string]: unknown;
+}
+
+/**
+ * A uniquely identifying ID for a request in JSON-RPC.
+ */
+export type RequestId = string | number;
+
+/**
+ * A request that expects a response.
+ */
+export interface JSONRPCRequest extends Request {
+ jsonrpc: typeof JSONRPC_VERSION;
+ id: RequestId;
+}
+
+/**
+ * A notification which does not expect a response.
+ */
+export interface JSONRPCNotification extends Notification {
+ jsonrpc: typeof JSONRPC_VERSION;
+}
+
+/**
+ * A successful (non-error) response to a request.
+ */
+export interface JSONRPCResponse {
+ jsonrpc: typeof JSONRPC_VERSION;
+ id: RequestId;
+ result: Result;
+}
+
+// Standard JSON-RPC error codes
+export const PARSE_ERROR = -32700;
+export const INVALID_REQUEST = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS = -32602;
+export const INTERNAL_ERROR = -32603;
+
+/**
+ * A response to a request that indicates an error occurred.
+ */
+export interface JSONRPCError {
+ jsonrpc: typeof JSONRPC_VERSION;
+ id: RequestId;
+ error: {
+ /**
+ * The error type that occurred.
+ */
+ code: number;
+ /**
+ * A short description of the error. The message SHOULD be limited to a concise single sentence.
+ */
+ message: string;
+ /**
+ * Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
+ */
+ data?: unknown;
+ };
+}
+
+/* Empty result */
+/**
+ * A response that indicates success but carries no data.
+ */
+export type EmptyResult = Result;
+
+/* Initialization */
+export const PROTOCOL_VERSION = 1;
+/**
+ * This request is sent from the client to the server when it first connects, asking it to begin initialization.
+ */
+export interface InitializeRequest extends Request {
+ method: "initialize";
+ params: {
+ /**
+ * The latest version of the Model Context Protocol that the client supports. The client MAY decide to support older versions as well.
+ */
+ protocolVersion: typeof PROTOCOL_VERSION;
+ capabilities: ClientCapabilities;
+ clientInfo: Implementation;
+ };
+}
+
+/**
+ * After receiving an initialize request from the client, the server sends this response.
+ */
+export interface InitializeResult extends Result {
+ /**
+ * The version of the Model Context Protocol that the server wants to use. This may not match the version that the client requested. If the client cannot support this version, it MUST disconnect.
+ */
+ protocolVersion: typeof PROTOCOL_VERSION;
+ capabilities: ServerCapabilities;
+ serverInfo: Implementation;
+}
+
+/**
+ * This notification is sent from the client to the server after initialization has finished.
+ */
+export interface InitializedNotification extends Notification {
+ method: "notifications/initialized";
+}
+
+/**
+ * Capabilities a client may support. Known capabilities are defined here, in this schema, but this is not a closed set: any client can define its own, additional capabilities.
+ */
+export interface ClientCapabilities {
+ /**
+ * Experimental, non-standard capabilities that the client supports.
+ */
+ experimental?: { [key: string]: object };
+ /**
+ * Present if the client supports sampling from an LLM.
+ */
+ sampling?: object;
+}
+
+/**
+ * Capabilities that a server may support. Known capabilities are defined here, in this schema, but this is not a closed set: any server can define its own, additional capabilities.
+ */
+export interface ServerCapabilities {
+ /**
+ * Experimental, non-standard capabilities that the server supports.
+ */
+ experimental?: { [key: string]: object };
+ /**
+ * Present if the server supports sending log messages to the client.
+ */
+ logging?: object;
+ /**
+ * Present if the server offers any prompt templates.
+ */
+ prompts?: object;
+ /**
+ * Present if the server offers any resources to read.
+ */
+ resources?: {
+ /**
+ * Whether this server supports subscribing to resource updates.
+ */
+ subscribe?: boolean;
+ };
+ /**
+ * Present if the server offers any tools to call.
+ */
+ tools?: object;
+}
+
+/**
+ * Describes the name and version of an MCP implementation.
+ */
+export interface Implementation {
+ name: string;
+ version: string;
+}
+
+/* Ping */
+/**
+ * A ping, issued by either the server or the client, to check that the other party is still alive. The receiver must promptly respond, or else may be disconnected.
+ */
+export interface PingRequest extends Request {
+ method: "ping";
+}
+
+/* Progress notifications */
+/**
+ * An out-of-band notification used to inform the receiver of a progress update for a long-running request.
+ */
+export interface ProgressNotification extends Notification {
+ method: "notifications/progress";
+ params: {
+ /**
+ * The progress token which was given in the initial request, used to associate this notification with the request that is proceeding.
+ */
+ progressToken: ProgressToken;
+ /**
+ * The progress thus far. This should increase every time progress is made, even if the total is unknown.
+ *
+ * @TJS-type number
+ */
+ progress: number;
+ /**
+ * Total number of items to process (or total progress required), if known.
+ *
+ * @TJS-type number
+ */
+ total?: number;
+ };
+}
+
+/* Resources */
+/**
+ * Sent from the client to request a list of resources the server has.
+ */
+export interface ListResourcesRequest extends Request {
+ method: "resources/list";
+}
+
+/**
+ * The server's response to a resources/list request from the client.
+ */
+export interface ListResourcesResult extends Result {
+ resourceTemplates?: ResourceTemplate[];
+ resources?: Resource[];
+}
+
+/**
+ * Sent from the client to the server, to read a specific resource URI.
+ */
+export interface ReadResourceRequest extends Request {
+ method: "resources/read";
+ params: {
+ /**
+ * The URI of the resource to read. The URI can use any protocol; it is up to the server how to interpret it.
+ *
+ * @format uri
+ */
+ uri: string;
+ };
+}
+
+/**
+ * The server's response to a resources/read request from the client.
+ */
+export interface ReadResourceResult extends Result {
+ contents: (TextResourceContents | BlobResourceContents)[];
+}
+
+/**
+ * An optional notification from the server to the client, informing it that the list of resources it can read from has changed. This may be issued by servers without any previous subscription from the client.
+ */
+export interface ResourceListChangedNotification extends Notification {
+ method: "notifications/resources/list_changed";
+}
+
+/**
+ * Sent from the client to request resources/updated notifications from the server whenever a particular resource changes.
+ */
+export interface SubscribeRequest extends Request {
+ method: "resources/subscribe";
+ params: {
+ /**
+ * The URI of the resource to subscribe to. The URI can use any protocol; it is up to the server how to interpret it.
+ *
+ * @format uri
+ */
+ uri: string;
+ };
+}
+
+/**
+ * Sent from the client to request cancellation of resources/updated notifications from the server. This should follow a previous resources/subscribe request.
+ */
+export interface UnsubscribeRequest extends Request {
+ method: "resources/unsubscribe";
+ params: {
+ /**
+ * The URI of the resource to unsubscribe from.
+ *
+ * @format uri
+ */
+ uri: string;
+ };
+}
+
+/**
+ * A notification from the server to the client, informing it that a resource has changed and may need to be read again. This should only be sent if the client previously sent a resources/subscribe request.
+ */
+export interface ResourceUpdatedNotification extends Notification {
+ method: "notifications/resources/updated";
+ params: {
+ /**
+ * The URI of the resource that has been updated. This might be a sub-resource of the one that the client actually subscribed to.
+ *
+ * @format uri
+ */
+ uri: string;
+ };
+}
+
+/**
+ * A known resource that the server is capable of reading.
+ */
+export interface Resource {
+ /**
+ * The URI of this resource.
+ *
+ * @format uri
+ */
+ uri: string;
+ /**
+ * The MIME type of this resource, if known.
+ */
+ mimeType?: string;
+}
+
+/**
+ * A template description for resources available on the server.
+ */
+export interface ResourceTemplate {
+ /**
+ * A URI template (according to RFC 6570) that can be used to construct resource URIs.
+ *
+ * @format uri-template
+ */
+ uriTemplate: string;
+ /**
+ * A human-readable name for the type of resource this template refers to.
+ */
+ name?: string;
+ /**
+ * A human-readable description of what this template is for.
+ */
+ description?: string;
+ /**
+ * The MIME type for all resources that match this template. This should only be included if all resources matching this template have the same type.
+ */
+ mimeType?: string;
+}
+
+/**
+ * The contents of a specific resource or sub-resource.
+ */
+export interface ResourceContents {
+ /**
+ * The URI of this resource.
+ *
+ * @format uri
+ */
+ uri: string;
+ /**
+ * The MIME type of this resource, if known.
+ */
+ mimeType?: string;
+}
+
+export interface TextResourceContents extends ResourceContents {
+ /**
+ * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+ */
+ text: string;
+}
+
+export interface BlobResourceContents extends ResourceContents {
+ /**
+ * A base64-encoded string representing the binary data of the item.
+ *
+ * @format byte
+ */
+ blob: string;
+}
+
+/* Prompts */
+/**
+ * Sent from the client to request a list of prompts and prompt templates the server has.
+ */
+export interface ListPromptsRequest extends Request {
+ method: "prompts/list";
+}
+
+/**
+ * The server's response to a prompts/list request from the client.
+ */
+export interface ListPromptsResult extends Result {
+ prompts: Prompt[];
+}
+
+/**
+ * Used by the client to get a prompt provided by the server.
+ */
+export interface GetPromptRequest extends Request {
+ method: "prompts/get";
+ params: {
+ /**
+ * The name of the prompt or prompt template.
+ */
+ name: string;
+ /**
+ * Arguments to use for templating the prompt.
+ */
+ arguments?: { [key: string]: string };
+ };
+}
+
+/**
+ * The server's response to a prompts/get request from the client.
+ */
+export interface GetPromptResult extends Result {
+ /**
+ * An optional description for the prompt.
+ */
+ description?: string;
+ messages: SamplingMessage[];
+}
+
+/**
+ * A prompt or prompt template that the server offers.
+ */
+export interface Prompt {
+ /**
+ * The name of the prompt or prompt template.
+ */
+ name: string;
+ /**
+ * An optional description of what this prompt provides
+ */
+ description?: string;
+ /**
+ * A list of arguments to use for templating the prompt.
+ */
+ arguments?: PromptArgument[];
+}
+
+/**
+ * Describes an argument that a prompt can accept.
+ */
+export interface PromptArgument {
+ /**
+ * The name of the argument.
+ */
+ name: string;
+ /**
+ * A human-readable description of the argument.
+ */
+ description?: string;
+ /**
+ * Whether this argument must be provided.
+ */
+ required?: boolean;
+}
+
+/* Tools */
+/**
+ * Sent from the client to request a list of tools the server has.
+ */
+export interface ListToolsRequest extends Request {
+ method: "tools/list";
+}
+
+/**
+ * The server's response to a tools/list request from the client.
+ */
+export interface ListToolsResult extends Result {
+ tools: Tool[];
+}
+
+/**
+ * The server's response to a tool call.
+ */
+export interface CallToolResult extends Result {
+ toolResult: unknown;
+}
+
+/**
+ * Used by the client to invoke a tool provided by the server.
+ */
+export interface CallToolRequest extends Request {
+ method: "tools/call";
+ params: {
+ name: string;
+ arguments?: { [key: string]: unknown };
+ };
+}
+
+/**
+ * An optional notification from the server to the client, informing it that the list of tools it offers has changed. This may be issued by servers without any previous subscription from the client.
+ */
+export interface ToolListChangedNotification extends Notification {
+ method: "notifications/tools/list_changed";
+}
+
+/**
+ * Definition for a tool the client can call.
+ */
+export interface Tool {
+ /**
+ * The name of the tool.
+ */
+ name: string;
+ /**
+ * A human-readable description of the tool.
+ */
+ description?: string;
+ /**
+ * A JSON Schema object defining the expected parameters for the tool.
+ */
+ inputSchema: {
+ type: "object";
+ properties?: { [key: string]: object };
+ };
+}
+
+/* Logging */
+/**
+ * A request from the client to the server, to enable or adjust logging.
+ */
+export interface SetLevelRequest extends Request {
+ method: "logging/setLevel";
+ params: {
+ /**
+ * The level of logging that the client wants to receive from the server. The server should send all logs at this level and higher (i.e., more severe) to the client as notifications/logging/message.
+ */
+ level: LoggingLevel;
+ };
+}
+
+/**
+ * Notification of a log message passed from server to client. If no logging/setLevel request has been sent from the client, the server MAY decide which messages to send automatically.
+ */
+export interface LoggingMessageNotification extends Notification {
+ method: "notifications/message";
+ params: {
+ /**
+ * The severity of this log message.
+ */
+ level: LoggingLevel;
+ /**
+ * An optional name of the logger issuing this message.
+ */
+ logger?: string;
+ /**
+ * The data to be logged, such as a string message or an object. Any JSON serializable type is allowed here.
+ */
+ data: unknown;
+ };
+}
+
+/**
+ * The severity of a log message.
+ */
+export type LoggingLevel = "debug" | "info" | "warning" | "error";
+
+/* Sampling */
+/**
+ * A request from the server to sample an LLM via the client. The client has full discretion over which model to select. The client should also inform the user before beginning sampling, to allow them to inspect the request (human in the loop) and decide whether to approve it.
+ */
+export interface CreateMessageRequest extends Request {
+ method: "sampling/createMessage";
+ params: {
+ messages: SamplingMessage[];
+ /**
+ * An optional system prompt the server wants to use for sampling. The client MAY modify or omit this prompt.
+ */
+ systemPrompt?: string;
+ /**
+ * A request to include context from one or more MCP servers (including the caller), to be attached to the prompt. The client MAY ignore this request.
+ */
+ includeContext?: "none" | "thisServer" | "allServers";
+ /**
+ * @TJS-type number
+ */
+ temperature?: number;
+ /**
+ * The maximum number of tokens to sample, as requested by the server. The client MAY choose to sample fewer tokens than requested.
+ */
+ maxTokens: number;
+ stopSequences?: string[];
+ /**
+ * Optional metadata to pass through to the LLM provider. The format of this metadata is provider-specific.
+ */
+ metadata?: object;
+ };
+}
+
+/**
+ * The client's response to a sampling/create_message request from the server. The client should inform the user before returning the sampled message, to allow them to inspect the response (human in the loop) and decide whether to allow the server to see it.
+ */
+export interface CreateMessageResult extends Result, SamplingMessage {
+ /**
+ * The name of the model that generated the message.
+ */
+ model: string;
+ /**
+ * The reason why sampling stopped.
+ */
+ stopReason: "endTurn" | "stopSequence" | "maxTokens";
+}
+
+/**
+ * Describes a message issued to or received from an LLM API.
+ */
+export interface SamplingMessage {
+ role: "user" | "assistant";
+ content: TextContent | ImageContent;
+}
+
+/**
+ * Text provided to or from an LLM.
+ */
+export interface TextContent {
+ type: "text";
+ /**
+ * The text content of the message.
+ */
+ text: string;
+}
+
+/**
+ * An image provided to or from an LLM.
+ */
+export interface ImageContent {
+ type: "image";
+ /**
+ * The base64-encoded image data.
+ *
+ * @format byte
+ */
+ data: string;
+ /**
+ * The MIME type of the image. Different providers may support different image types.
+ */
+ mimeType: string;
+}
+
+/* Autocomplete */
+/**
+ * A request from the client to the server, to ask for completion options.
+ */
+export interface CompleteRequest extends Request {
+ method: "completion/complete";
+ params: {
+ ref: PromptReference | ResourceReference;
+ /**
+ * The argument's information
+ */
+ argument: {
+ /**
+ * The name of the argument
+ */
+ name: string;
+ /**
+ * The value of the argument to use for completion matching.
+ */
+ value: string;
+ };
+ };
+}
+
+/**
+ * The server's response to a completion/complete request
+ */
+export interface CompleteResult extends Result {
+ completion: {
+ /**
+ * An array of completion values. Must not exceed 100 items.
+ */
+ values: string[];
+ /**
+ * The total number of completion options available. This can exceed the number of values actually sent in the response.
+ */
+ total?: number;
+ /**
+ * Indicates whether there are additional completion options beyond those provided in the current response, even if the exact total is unknown.
+ */
+ hasMore?: boolean;
+ };
+}
+
+/**
+ * A reference to a resource or resource template definition.
+ */
+export interface ResourceReference {
+ type: "ref/resource";
+ /**
+ * The URI or URI template of the resource.
+ *
+ * @format uri-template
+ */
+ uri: string;
+}
+
+/**
+ * Identifies a prompt.
+ */
+export interface PromptReference {
+ type: "ref/prompt";
+ /**
+ * The name of the prompt or prompt template
+ */
+ name: string;
+}
+
+/* Client messages */
+export type ClientRequest =
+ | PingRequest
+ | InitializeRequest
+ | CompleteRequest
+ | SetLevelRequest
+ | GetPromptRequest
+ | ListPromptsRequest
+ | ListResourcesRequest
+ | ReadResourceRequest
+ | SubscribeRequest
+ | UnsubscribeRequest
+ | CallToolRequest
+ | ListToolsRequest;
+
+export type ClientNotification = ProgressNotification | InitializedNotification;
+export type ClientResult = EmptyResult | CreateMessageResult;
+
+/* Server messages */
+export type ServerRequest = PingRequest | CreateMessageRequest;
+
+export type ServerNotification =
+ | ProgressNotification
+ | LoggingMessageNotification
+ | ResourceUpdatedNotification
+ | ResourceListChangedNotification
+ | ToolListChangedNotification;
+
+export type ServerResult =
+ | EmptyResult
+ | InitializeResult
+ | CompleteResult
+ | GetPromptResult
+ | ListPromptsResult
+ | ListResourcesResult
+ | ReadResourceResult
+ | CallToolResult
+ | ListToolsResult;
diff --git a/scripts/validate_examples.ts b/scripts/validate_examples.ts
new file mode 100644
index 0000000..15f48e6
--- /dev/null
+++ b/scripts/validate_examples.ts
@@ -0,0 +1,62 @@
+import * as fs from "fs";
+import Ajv, { ValidateFunction } from "ajv";
+import { globSync } from "glob";
+import addFormats from "ajv-formats";
+import { readFileSync } from "node:fs";
+
+function createAjvInstance(): { ajv: Ajv; validate: ValidateFunction } {
+ const ajv = new Ajv({
+ // strict: true,
+ allowUnionTypes: true,
+ });
+ addFormats(ajv);
+ const schema = JSON.parse(readFileSync("schema/schema.json", "utf8"));
+ const validate = ajv.compile(schema);
+
+ return { ajv, validate };
+}
+
+function validateJsonBlocks(
+ validate: ValidateFunction,
+ filePath: string,
+): void {
+ const content = fs.readFileSync(filePath, "utf8");
+ const jsonBlocks = content.match(/```json\s*\n([\s\S]*?)\n\s*```/g);
+
+ if (!jsonBlocks) {
+ console.log("No JSON blocks found in the file.");
+ return;
+ }
+
+ jsonBlocks.forEach((block, index) => {
+ try {
+ const jsonContent = block.replace(/```json\s*\n|\n\s*```/g, "");
+ const parsedJson = JSON.parse(jsonContent);
+ const valid = validate(parsedJson);
+
+ if (valid) {
+ console.log(`JSON block ${index + 1} is valid.`);
+ } else {
+ console.log(`JSON block ${index + 1} is invalid:`);
+ console.log(parsedJson);
+ console.log(validate.errors);
+ }
+ } catch (error) {
+ console.error(
+ `Error parsing JSON block ${index + 1}:`,
+ (error as Error).message,
+ );
+ }
+ });
+}
+
+const { validate } = createAjvInstance();
+
+// Usage
+const mdFiles = globSync("examples/**/*.md", {});
+
+mdFiles.forEach((filePath) => {
+ console.log(`Validating JSON blocks in ${filePath}:`);
+ validateJsonBlocks(validate, filePath);
+ console.log("\n"); // Add a newline for separation between files
+});
diff --git a/site/.gitignore b/site/.gitignore
new file mode 100644
index 0000000..56af776
--- /dev/null
+++ b/site/.gitignore
@@ -0,0 +1,2 @@
+public/
+*.lock
diff --git a/site/go.mod b/site/go.mod
new file mode 100644
index 0000000..721c81a
--- /dev/null
+++ b/site/go.mod
@@ -0,0 +1,5 @@
+module https://github.com/modelcontextprotocol/specification
+
+go 1.23.1
+
+require github.com/imfing/hextra v0.8.3 // indirect
diff --git a/site/go.sum b/site/go.sum
new file mode 100644
index 0000000..60e6bd2
--- /dev/null
+++ b/site/go.sum
@@ -0,0 +1,2 @@
+github.com/imfing/hextra v0.8.3 h1:peKCtkOwcVMQV2EqMb/VUhwpYDsI1B14U1rDqAgMHzk=
+github.com/imfing/hextra v0.8.3/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI=
diff --git a/site/hugo.yaml b/site/hugo.yaml
new file mode 100644
index 0000000..996f73a
--- /dev/null
+++ b/site/hugo.yaml
@@ -0,0 +1,64 @@
+baseURL: "https://legendary-broccoli-1p63635.pages.github.io/"
+title: "Model Context Protocol"
+
+enableRobotsTXT: true
+enableGitInfo: true
+
+outputs:
+ home: [HTML]
+ page: [HTML]
+ section: [HTML, RSS]
+
+module:
+ imports:
+ - path: github.com/imfing/hextra
+
+
+
+contentDir: ../docs
+
+markup:
+ goldmark:
+ renderer:
+ unsafe: false
+ extensions:
+ definitionList: true
+ footnote: true
+ linkify: true
+ linkifyProtocol: https
+ strikethrough: true
+ table: true
+ typographer:
+ apostrophe: "’"
+ disable: false
+ ellipsis: "…"
+ emDash: "—"
+ enDash: "–"
+ leftAngleQuote: "«"
+ leftDoubleQuote: "“"
+ leftSingleQuote: "‘"
+ rightAngleQuote: "»"
+ rightDoubleQuote: "”"
+ rightSingleQuote: "’"
+ highlight:
+ noClasses: false
+
+enableInlineShortcodes: true
+
+menu:
+ main:
+ - name: Guide
+ pageRef: /guide
+ weight: 1
+ - name: Specification
+ pageRef: /spec
+ weight: 2
+ - name: Search
+ weight: 3
+ params:
+ type: search
+ - name: GitHub
+ weight: 4
+ url: "https://github.com/modelcontextprotocol/spec"
+ params:
+ icon: github
diff --git a/spec/model-context-protocol.md b/spec/model-context-protocol.md
new file mode 100644
index 0000000..8481581
--- /dev/null
+++ b/spec/model-context-protocol.md
@@ -0,0 +1,180 @@
+# Model Context Protocol
+
+_**NOTE:** This is a very early draft. Feel free to discuss changes, requirements, etc._
+
+# Goal
+
+The Model Context Protocol (MCP) is an attempt to allow implementors to provide context to various LLM surfaces such as editors/IDEs, [claude.ai](https://claude.ai), etc., in a pluggable way. It separates the concerns of providing context from the LLM loop and its usage within.
+
+This makes it **much** easier for anyone to script LLM applications for accomplishing their custom workflows, without the application needing to directly offer a large number of integrations.
+
+# Terminology
+
+The Model Context Protocol is inspired by Microsoft's [Language Server Protocol](https://microsoft.github.io/language-server-protocol/), with similar concepts:
+
+* **Server**: a process or service providing context via MCP.
+* **Client**: the initiator and client connection to a single MCP server. A message sent through a client is always directed to its one corresponding server.
+* **Host**: a process or service which runs any number of MCP clients. [For example, your editor might be a host, claude.ai might be a host, etc.](#example-hosts)
+* **Session**: a stateful session established between one client and server.
+* **Message**: a message refers to one of the following types of [JSON-RPC](https://www.jsonrpc.org/) object:
+ * **Request:** a request includes a `method` and `params`, and can be sent by either the server or the client, asking the other for some information or to perform some operation.
+ * **Response:** a response includes a `result` or an `error`, and is sent *back* after a request, once processing has finished (successfully or unsuccessfully).
+ * **Notification:** a special type of a request that does not expect a response, notifications are emitted by either the server or client to unilaterally inform the other of an event or state change.
+* **Capability**: a feature that the client or server supports. When an MCP connection is initiated, the client and server negotiate the capabilities that they both support, which affects the rest of the interaction.
+
+## Primitives
+
+On top of the base protocol, MCP introduces these unique primitives:
+
+* **Resources**: anything that can be loaded as context for an LLM. *Servers* expose a list of resources, identified with [URIs](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier), which the *client* can choose to read or (if supported) subscribe to. Resources can be text or binary data—there are no restrictions on their content.
+* **Prompts**: prompts or prompt templates that the *server* can provide to the *client*, which the client can easily surface in the UI (e.g., as some sort of slash command).
+* **Tools**: functionality that the *client* can invoke on the *server*, to perform effectful operations. The client can choose to [expose these tools directly to the LLM](https://docs.anthropic.com/en/docs/build-with-claude/tool-use) too, allowing it to decide when and how to use them.
+* **Sampling**: *servers* can ask the *client* to sample from the LLM, which allows servers to implement agentic behaviors without having to implement sampling themselves. This also allows the client to combine the sampling request with *all of the other context it has*, making it much more intelligent—while avoiding needlessly exfiltrating information to servers.
+
+```mermaid
+flowchart LR
+ server["Server\nScript on local machine, web service, etc."]
+ host["Host (client)\nEditors, claude.ai, etc."]
+
+ host -->|"resource queries"| server
+ host -->|"invoke tools"| server
+ server -->|"sampling"| host
+ server -.->|"prompt templates"| host
+ server -.->|"resource contents"| host
+```
+
+## Control
+
+In addition to basic primitives, MCP offers a set of control flow messages.
+
+* **Logging:** Anything related to how the server processes logs.
+* **Completion**: Supports completion of server arguments on the client side. See
+
+# Use cases
+
+Most use cases are around enabling people to build their own specific workflows and integrations. MCP enables engineers and teams to **tailor AI to their needs.**
+
+The beauty of the Model Context Protocol is that it's **extremely composable**. You can imagine mixing and matching *any number* of the example servers below with any one of the hosts. Each individual server can be quite simple and limited, but *composed together*, you can get a super-powered AI!
+
+## Example servers
+
+* **File watcher**: read entire local directories, exposed as resources, and subscribe to changes. The server can provide a tool to write changes back to disk too!
+* **Screen watcher**: follow along with the user, taking screenshots automatically, and exposing those as resources. The host can use this to automatically attach screen captures to LLM context.
+* **Git integration**: could expose context like Git commit history, but probably *most* useful as a source of tools, like: "commit these changes," "merge this and resolve conflicts," etc.
+* **GitHub integration**: read and expose GitHub resources: files, commits, pull requests, issues, etc. Could also expose one or more tools to modify GitHub resources, like "create a PR."
+* **Asana integration**: similarly to GitHub—read/write Asana projects, tasks, etc.
+* **Slack integration**: read context from Slack channels. Could also look for specially tagged messages, or invocations of [shortcuts](https://api.slack.com/interactivity/shortcuts), as sources of context. Could expose tools to post messages to Slack.
+* **Google Workspace integration**: read and write emails, docs, etc.
+* **IDEs and editors**: IDEs and editors can be [servers](#example-hosts-clients) as well as hosts! As servers, they can be a rich source of context like: output/status of tests, [ASTs](https://en.wikipedia.org/wiki/Abstract_syntax_tree) and parse trees, and "which files are currently open and being edited?"
+
+A key design principle of MCP is that it should be *as simple as possible* to implement a server. We want anyone to be able to write, e.g., a local Python script of 100 or fewer lines and get a fully functioning server, with capabilities comparable to any of the above.
+
+## Example hosts
+
+* **IDEs and editors**: An MCP host inside an IDE or editor could support attaching any number of servers, which can be used to populate an in-editor LLM chat interface, as well as (e.g.) contextualize refactoring. In future, we could also imagine populating editors' command palette with all of the tools that MCP servers have made available.
+* **claude.ai**: [Claude.ai](https://claude.ai) can become an MCP host, allowing users to connect any number of MCP servers. Resources from those servers could be automatically made available for attaching to any Project or Chat. Claude could also make use of the tools exposed by MCP servers to implement agentic behaviors, saving artifacts to disk or to web services, etc.!
+* **Slack**: [Claude in Slack](https://www.anthropic.com/claude-in-slack) on steroids! Building an MCP host into Slack would open the door to much more complex interactions with LLMs via the platform—both in being able to read context from any number of places (for example, all the servers posited above), as well as being able to *take actions*, from Slack, via the tools that MCP servers expose.
+
+# Protocol
+
+## Initialization
+
+MCP [sessions](#terminology) begin with an initialization phase, where the client and server identify each other, and exchange information about their respective [capabilities](#terminology).
+
+The client can only begin requesting resources and invoking tools on the server, and the server can only begin requesting LLM sampling, after the client has issued the `initialized` notification:
+
+```mermaid
+sequenceDiagram
+ participant client as Client
+ participant server as Server
+
+ activate client
+ client -->>+ server: (connect over transport)
+ client -->> server: initialize
+ server -->> client: initialize_response
+ client --) server: initialized (notification)
+
+ loop while connected
+ alt client to server
+ client -->> server: request
+ server -->> client: response
+ else
+ client --) server: notification
+ else server to client
+ server -->> client: request
+ client -->> server: response
+ else
+ server --) client: notification
+ end
+ end
+
+ deactivate server
+ deactivate client
+```
+
+## Transports
+
+An MCP server or client must implement one of the following transports. Different transports require different clients (but each can run within the same *host*).
+
+### stdio
+
+The client spawns the server process and manages its lifetime, and writes messages to it on the server's stdin. The server writes messages back to the client on its stdout.
+
+Individual JSON-RPC messages are sent as newline-terminated JSON over the interface.
+
+Anything the server writes to stderr MAY be captured as logging, but the client is also allowed to ignore it completely.
+
+### SSE
+
+A client can open a [Server-Sent Events](https://en.wikipedia.org/wiki/Server-sent_events) connection to a server, which the server will use to push all of its requests and responses to the client.
+
+Upon connection, the server MUST issue a `endpoint` event (which is specific to MCP, not a default SSE event). The `data` associated with an `endpoint` event MUST be a URI for the client to use. The endpoint can be a relative or an absolute URI, but MUST always point to the same server origin. Cross-origin endpoints are not allowed, for security.
+
+The client MUST issue individual JSON-RPC messages through the endpoint identified by the server, using HTTP POST requests—this allows the server to link these out-of-band messages with the ongoing SSE stream.
+
+In turn, `message` events on the SSE stream will contain individual JSON-RPC messages from the server. The server MUST NOT send a `message` event until after the `endpoint` event has been issued.
+
+This sequence diagram shows the MCP initialization flow over SSE, followed by open-ended communication between client and server, until ultimately the client disconnects:
+
+```mermaid
+sequenceDiagram
+ participant client as MCP Client
+ participant server as MCP Server
+
+ activate client
+ client->>+server: new EventSource("https://server/mcp")
+ server->>client: event: endpoint
data: /session?id=8cfc516c-…
+
+ client-->>server: POST https://server/session?id=…
{InitializeRequest}
+ server->>client: event: message
data: {InitializeResponse}
+
+ client--)server: POST https://server/session?id=…
{InitializedNotification}
+
+ loop client requests and responses
+ client--)server: POST https://server/session?id=…
{…}
+ end
+
+ loop server requests and responses
+ server-)client: event: message
data: {…}
+ end
+
+ client -x server: EventSource.close()
+
+ deactivate server
+ deactivate client
+```
+
+## Security and T&S considerations
+
+This model, while it will be *revolutionary* for productivity and product experience, is effectively a form of arbitrary data access and arbitrary code execution.
+
+**Every interaction between MCP host and server will need informed user consent.** For example:
+
+* Servers must only expose user data as [resources](#primitives) with the user's explicit consent. Hosts must not transmit that data elsewhere without the user's explicit consent.
+* Hosts must not invoke tools on servers without the user's explicit consent, and understanding of what the tool will do.
+* When a server initiates [sampling](#primitives) via a host, the user must have control over:
+ * *Whether* sampling even occurs. (They may not want to be charged!)
+ * What the prompt that will actually be sampled is.
+ * *What the server sees* of the completion when sampling finishes.
+
+This latter point is why the sampling primitives do not permit MCP servers to see the whole prompt—instead, the host remains in control, and can censor or modify it at will.
diff --git a/yarn.lock b/yarn.lock
new file mode 100644
index 0000000..858354d
--- /dev/null
+++ b/yarn.lock
@@ -0,0 +1,753 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+
+"@cspotcode/source-map-support@^0.8.0":
+ version "0.8.1"
+ resolved "https://registry.yarnpkg.com/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz#00629c35a688e05a88b1cda684fb9d5e73f000a1"
+ integrity sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==
+ dependencies:
+ "@jridgewell/trace-mapping" "0.3.9"
+
+"@esbuild/aix-ppc64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.23.1.tgz#51299374de171dbd80bb7d838e1cfce9af36f353"
+ integrity sha512-6VhYk1diRqrhBAqpJEdjASR/+WVRtfjpqKuNw11cLiaWpAT/Uu+nokB+UJnevzy/P9C/ty6AOe0dwueMrGh/iQ==
+
+"@esbuild/android-arm64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.23.1.tgz#58565291a1fe548638adb9c584237449e5e14018"
+ integrity sha512-xw50ipykXcLstLeWH7WRdQuysJqejuAGPd30vd1i5zSyKK3WE+ijzHmLKxdiCMtH1pHz78rOg0BKSYOSB/2Khw==
+
+"@esbuild/android-arm@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.23.1.tgz#5eb8c652d4c82a2421e3395b808e6d9c42c862ee"
+ integrity sha512-uz6/tEy2IFm9RYOyvKl88zdzZfwEfKZmnX9Cj1BHjeSGNuGLuMD1kR8y5bteYmwqKm1tj8m4cb/aKEorr6fHWQ==
+
+"@esbuild/android-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.23.1.tgz#ae19d665d2f06f0f48a6ac9a224b3f672e65d517"
+ integrity sha512-nlN9B69St9BwUoB+jkyU090bru8L0NA3yFvAd7k8dNsVH8bi9a8cUAUSEcEEgTp2z3dbEDGJGfP6VUnkQnlReg==
+
+"@esbuild/darwin-arm64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.23.1.tgz#05b17f91a87e557b468a9c75e9d85ab10c121b16"
+ integrity sha512-YsS2e3Wtgnw7Wq53XXBLcV6JhRsEq8hkfg91ESVadIrzr9wO6jJDMZnCQbHm1Guc5t/CdDiFSSfWP58FNuvT3Q==
+
+"@esbuild/darwin-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.23.1.tgz#c58353b982f4e04f0d022284b8ba2733f5ff0931"
+ integrity sha512-aClqdgTDVPSEGgoCS8QDG37Gu8yc9lTHNAQlsztQ6ENetKEO//b8y31MMu2ZaPbn4kVsIABzVLXYLhCGekGDqw==
+
+"@esbuild/freebsd-arm64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.23.1.tgz#f9220dc65f80f03635e1ef96cfad5da1f446f3bc"
+ integrity sha512-h1k6yS8/pN/NHlMl5+v4XPfikhJulk4G+tKGFIOwURBSFzE8bixw1ebjluLOjfwtLqY0kewfjLSrO6tN2MgIhA==
+
+"@esbuild/freebsd-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.23.1.tgz#69bd8511fa013b59f0226d1609ac43f7ce489730"
+ integrity sha512-lK1eJeyk1ZX8UklqFd/3A60UuZ/6UVfGT2LuGo3Wp4/z7eRTRYY+0xOu2kpClP+vMTi9wKOfXi2vjUpO1Ro76g==
+
+"@esbuild/linux-arm64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.23.1.tgz#8050af6d51ddb388c75653ef9871f5ccd8f12383"
+ integrity sha512-/93bf2yxencYDnItMYV/v116zff6UyTjo4EtEQjUBeGiVpMmffDNUyD9UN2zV+V3LRV3/on4xdZ26NKzn6754g==
+
+"@esbuild/linux-arm@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.23.1.tgz#ecaabd1c23b701070484990db9a82f382f99e771"
+ integrity sha512-CXXkzgn+dXAPs3WBwE+Kvnrf4WECwBdfjfeYHpMeVxWE0EceB6vhWGShs6wi0IYEqMSIzdOF1XjQ/Mkm5d7ZdQ==
+
+"@esbuild/linux-ia32@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.23.1.tgz#3ed2273214178109741c09bd0687098a0243b333"
+ integrity sha512-VTN4EuOHwXEkXzX5nTvVY4s7E/Krz7COC8xkftbbKRYAl96vPiUssGkeMELQMOnLOJ8k3BY1+ZY52tttZnHcXQ==
+
+"@esbuild/linux-loong64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.23.1.tgz#a0fdf440b5485c81b0fbb316b08933d217f5d3ac"
+ integrity sha512-Vx09LzEoBa5zDnieH8LSMRToj7ir/Jeq0Gu6qJ/1GcBq9GkfoEAoXvLiW1U9J1qE/Y/Oyaq33w5p2ZWrNNHNEw==
+
+"@esbuild/linux-mips64el@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.23.1.tgz#e11a2806346db8375b18f5e104c5a9d4e81807f6"
+ integrity sha512-nrFzzMQ7W4WRLNUOU5dlWAqa6yVeI0P78WKGUo7lg2HShq/yx+UYkeNSE0SSfSure0SqgnsxPvmAUu/vu0E+3Q==
+
+"@esbuild/linux-ppc64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.23.1.tgz#06a2744c5eaf562b1a90937855b4d6cf7c75ec96"
+ integrity sha512-dKN8fgVqd0vUIjxuJI6P/9SSSe/mB9rvA98CSH2sJnlZ/OCZWO1DJvxj8jvKTfYUdGfcq2dDxoKaC6bHuTlgcw==
+
+"@esbuild/linux-riscv64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.23.1.tgz#65b46a2892fc0d1af4ba342af3fe0fa4a8fe08e7"
+ integrity sha512-5AV4Pzp80fhHL83JM6LoA6pTQVWgB1HovMBsLQ9OZWLDqVY8MVobBXNSmAJi//Csh6tcY7e7Lny2Hg1tElMjIA==
+
+"@esbuild/linux-s390x@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.23.1.tgz#e71ea18c70c3f604e241d16e4e5ab193a9785d6f"
+ integrity sha512-9ygs73tuFCe6f6m/Tb+9LtYxWR4c9yg7zjt2cYkjDbDpV/xVn+68cQxMXCjUpYwEkze2RcU/rMnfIXNRFmSoDw==
+
+"@esbuild/linux-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.23.1.tgz#d47f97391e80690d4dfe811a2e7d6927ad9eed24"
+ integrity sha512-EV6+ovTsEXCPAp58g2dD68LxoP/wK5pRvgy0J/HxPGB009omFPv3Yet0HiaqvrIrgPTBuC6wCH1LTOY91EO5hQ==
+
+"@esbuild/netbsd-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.23.1.tgz#44e743c9778d57a8ace4b72f3c6b839a3b74a653"
+ integrity sha512-aevEkCNu7KlPRpYLjwmdcuNz6bDFiE7Z8XC4CPqExjTvrHugh28QzUXVOZtiYghciKUacNktqxdpymplil1beA==
+
+"@esbuild/openbsd-arm64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.23.1.tgz#05c5a1faf67b9881834758c69f3e51b7dee015d7"
+ integrity sha512-3x37szhLexNA4bXhLrCC/LImN/YtWis6WXr1VESlfVtVeoFJBRINPJ3f0a/6LV8zpikqoUg4hyXw0sFBt5Cr+Q==
+
+"@esbuild/openbsd-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.23.1.tgz#2e58ae511bacf67d19f9f2dcd9e8c5a93f00c273"
+ integrity sha512-aY2gMmKmPhxfU+0EdnN+XNtGbjfQgwZj43k8G3fyrDM/UdZww6xrWxmDkuz2eCZchqVeABjV5BpildOrUbBTqA==
+
+"@esbuild/sunos-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.23.1.tgz#adb022b959d18d3389ac70769cef5a03d3abd403"
+ integrity sha512-RBRT2gqEl0IKQABT4XTj78tpk9v7ehp+mazn2HbUeZl1YMdaGAQqhapjGTCe7uw7y0frDi4gS0uHzhvpFuI1sA==
+
+"@esbuild/win32-arm64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.23.1.tgz#84906f50c212b72ec360f48461d43202f4c8b9a2"
+ integrity sha512-4O+gPR5rEBe2FpKOVyiJ7wNDPA8nGzDuJ6gN4okSA1gEOYZ67N8JPk58tkWtdtPeLz7lBnY6I5L3jdsr3S+A6A==
+
+"@esbuild/win32-ia32@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.23.1.tgz#5e3eacc515820ff729e90d0cb463183128e82fac"
+ integrity sha512-BcaL0Vn6QwCwre3Y717nVHZbAa4UBEigzFm6VdsVdT/MbZ38xoj1X9HPkZhbmaBGUD1W8vxAfffbDe8bA6AKnQ==
+
+"@esbuild/win32-x64@0.23.1":
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.23.1.tgz#81fd50d11e2c32b2d6241470e3185b70c7b30699"
+ integrity sha512-BHpFFeslkWrXWyUPnbKm+xYYVYruCinGcftSBaa8zoF9hZO4BcSCFUvHVTtzpIY6YzUnYtuEhZ+C9iEXjxnasg==
+
+"@isaacs/cliui@^8.0.2":
+ version "8.0.2"
+ resolved "https://registry.yarnpkg.com/@isaacs/cliui/-/cliui-8.0.2.tgz#b37667b7bc181c168782259bab42474fbf52b550"
+ integrity sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==
+ dependencies:
+ string-width "^5.1.2"
+ string-width-cjs "npm:string-width@^4.2.0"
+ strip-ansi "^7.0.1"
+ strip-ansi-cjs "npm:strip-ansi@^6.0.1"
+ wrap-ansi "^8.1.0"
+ wrap-ansi-cjs "npm:wrap-ansi@^7.0.0"
+
+"@jridgewell/resolve-uri@^3.0.3":
+ version "3.1.2"
+ resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz#7a0ee601f60f99a20c7c7c5ff0c80388c1189bd6"
+ integrity sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==
+
+"@jridgewell/sourcemap-codec@^1.4.10":
+ version "1.5.0"
+ resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz#3188bcb273a414b0d215fd22a58540b989b9409a"
+ integrity sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==
+
+"@jridgewell/trace-mapping@0.3.9":
+ version "0.3.9"
+ resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz#6534fd5933a53ba7cbf3a17615e273a0d1273ff9"
+ integrity sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==
+ dependencies:
+ "@jridgewell/resolve-uri" "^3.0.3"
+ "@jridgewell/sourcemap-codec" "^1.4.10"
+
+"@pkgjs/parseargs@^0.11.0":
+ version "0.11.0"
+ resolved "https://registry.yarnpkg.com/@pkgjs/parseargs/-/parseargs-0.11.0.tgz#a77ea742fab25775145434eb1d2328cf5013ac33"
+ integrity sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==
+
+"@tsconfig/node10@^1.0.7":
+ version "1.0.11"
+ resolved "https://registry.yarnpkg.com/@tsconfig/node10/-/node10-1.0.11.tgz#6ee46400685f130e278128c7b38b7e031ff5b2f2"
+ integrity sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==
+
+"@tsconfig/node12@^1.0.7":
+ version "1.0.11"
+ resolved "https://registry.yarnpkg.com/@tsconfig/node12/-/node12-1.0.11.tgz#ee3def1f27d9ed66dac6e46a295cffb0152e058d"
+ integrity sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==
+
+"@tsconfig/node14@^1.0.0":
+ version "1.0.3"
+ resolved "https://registry.yarnpkg.com/@tsconfig/node14/-/node14-1.0.3.tgz#e4386316284f00b98435bf40f72f75a09dabf6c1"
+ integrity sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==
+
+"@tsconfig/node16@^1.0.2":
+ version "1.0.4"
+ resolved "https://registry.yarnpkg.com/@tsconfig/node16/-/node16-1.0.4.tgz#0b92dcc0cc1c81f6f306a381f28e31b1a56536e9"
+ integrity sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==
+
+"@types/json-schema@^7.0.9":
+ version "7.0.15"
+ resolved "https://registry.yarnpkg.com/@types/json-schema/-/json-schema-7.0.15.tgz#596a1747233694d50f6ad8a7869fcb6f56cf5841"
+ integrity sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==
+
+"@types/node@^18.11.9":
+ version "18.19.50"
+ resolved "https://registry.yarnpkg.com/@types/node/-/node-18.19.50.tgz#8652b34ee7c0e7e2004b3f08192281808d41bf5a"
+ integrity sha512-xonK+NRrMBRtkL1hVCc3G+uXtjh1Al4opBLjqVmipe5ZAaBYWW6cNAiBVZ1BvmkBhep698rP3UM3aRAdSALuhg==
+ dependencies:
+ undici-types "~5.26.4"
+
+acorn-walk@^8.1.1:
+ version "8.3.4"
+ resolved "https://registry.yarnpkg.com/acorn-walk/-/acorn-walk-8.3.4.tgz#794dd169c3977edf4ba4ea47583587c5866236b7"
+ integrity sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==
+ dependencies:
+ acorn "^8.11.0"
+
+acorn@^8.11.0, acorn@^8.4.1:
+ version "8.12.1"
+ resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.12.1.tgz#71616bdccbe25e27a54439e0046e89ca76df2248"
+ integrity sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==
+
+ajv-formats@^3.0.1:
+ version "3.0.1"
+ resolved "https://registry.yarnpkg.com/ajv-formats/-/ajv-formats-3.0.1.tgz#3d5dc762bca17679c3c2ea7e90ad6b7532309578"
+ integrity sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==
+ dependencies:
+ ajv "^8.0.0"
+
+ajv@^8.0.0, ajv@^8.17.1:
+ version "8.17.1"
+ resolved "https://registry.yarnpkg.com/ajv/-/ajv-8.17.1.tgz#37d9a5c776af6bc92d7f4f9510eba4c0a60d11a6"
+ integrity sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==
+ dependencies:
+ fast-deep-equal "^3.1.3"
+ fast-uri "^3.0.1"
+ json-schema-traverse "^1.0.0"
+ require-from-string "^2.0.2"
+
+ansi-regex@^5.0.1:
+ version "5.0.1"
+ resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-5.0.1.tgz#082cb2c89c9fe8659a311a53bd6a4dc5301db304"
+ integrity sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==
+
+ansi-regex@^6.0.1:
+ version "6.0.1"
+ resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-6.0.1.tgz#3183e38fae9a65d7cb5e53945cd5897d0260a06a"
+ integrity sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==
+
+ansi-styles@^4.0.0:
+ version "4.3.0"
+ resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-4.3.0.tgz#edd803628ae71c04c85ae7a0906edad34b648937"
+ integrity sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==
+ dependencies:
+ color-convert "^2.0.1"
+
+ansi-styles@^6.1.0:
+ version "6.2.1"
+ resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-6.2.1.tgz#0e62320cf99c21afff3b3012192546aacbfb05c5"
+ integrity sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==
+
+arg@^4.1.0:
+ version "4.1.3"
+ resolved "https://registry.yarnpkg.com/arg/-/arg-4.1.3.tgz#269fc7ad5b8e42cb63c896d5666017261c144089"
+ integrity sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==
+
+balanced-match@^1.0.0:
+ version "1.0.2"
+ resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.2.tgz#e83e3a7e3f300b34cb9d87f615fa0cbf357690ee"
+ integrity sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==
+
+brace-expansion@^1.1.7:
+ version "1.1.11"
+ resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-1.1.11.tgz#3c7fcbf529d87226f3d2f52b966ff5271eb441dd"
+ integrity sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==
+ dependencies:
+ balanced-match "^1.0.0"
+ concat-map "0.0.1"
+
+brace-expansion@^2.0.1:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-2.0.1.tgz#1edc459e0f0c548486ecf9fc99f2221364b9a0ae"
+ integrity sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==
+ dependencies:
+ balanced-match "^1.0.0"
+
+cliui@^8.0.1:
+ version "8.0.1"
+ resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa"
+ integrity sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==
+ dependencies:
+ string-width "^4.2.0"
+ strip-ansi "^6.0.1"
+ wrap-ansi "^7.0.0"
+
+color-convert@^2.0.1:
+ version "2.0.1"
+ resolved "https://registry.yarnpkg.com/color-convert/-/color-convert-2.0.1.tgz#72d3a68d598c9bdb3af2ad1e84f21d896abd4de3"
+ integrity sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==
+ dependencies:
+ color-name "~1.1.4"
+
+color-name@~1.1.4:
+ version "1.1.4"
+ resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.4.tgz#c2a09a87acbde69543de6f63fa3995c826c536a2"
+ integrity sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==
+
+concat-map@0.0.1:
+ version "0.0.1"
+ resolved "https://registry.yarnpkg.com/concat-map/-/concat-map-0.0.1.tgz#d8a96bd77fd68df7793a73036a3ba0d5405d477b"
+ integrity sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==
+
+create-require@^1.1.0:
+ version "1.1.1"
+ resolved "https://registry.yarnpkg.com/create-require/-/create-require-1.1.1.tgz#c1d7e8f1e5f6cfc9ff65f9cd352d37348756c333"
+ integrity sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==
+
+cross-spawn@^7.0.0:
+ version "7.0.3"
+ resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6"
+ integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==
+ dependencies:
+ path-key "^3.1.0"
+ shebang-command "^2.0.0"
+ which "^2.0.1"
+
+diff@^4.0.1:
+ version "4.0.2"
+ resolved "https://registry.yarnpkg.com/diff/-/diff-4.0.2.tgz#60f3aecb89d5fae520c11aa19efc2bb982aade7d"
+ integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==
+
+eastasianwidth@^0.2.0:
+ version "0.2.0"
+ resolved "https://registry.yarnpkg.com/eastasianwidth/-/eastasianwidth-0.2.0.tgz#696ce2ec0aa0e6ea93a397ffcf24aa7840c827cb"
+ integrity sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==
+
+emoji-regex@^8.0.0:
+ version "8.0.0"
+ resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-8.0.0.tgz#e818fd69ce5ccfcb404594f842963bf53164cc37"
+ integrity sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==
+
+emoji-regex@^9.2.2:
+ version "9.2.2"
+ resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-9.2.2.tgz#840c8803b0d8047f4ff0cf963176b32d4ef3ed72"
+ integrity sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==
+
+esbuild@~0.23.0:
+ version "0.23.1"
+ resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.23.1.tgz#40fdc3f9265ec0beae6f59824ade1bd3d3d2dab8"
+ integrity sha512-VVNz/9Sa0bs5SELtn3f7qhJCDPCF5oMEl5cO9/SSinpE9hbPVvxbd572HH5AKiP7WD8INO53GgfDDhRjkylHEg==
+ optionalDependencies:
+ "@esbuild/aix-ppc64" "0.23.1"
+ "@esbuild/android-arm" "0.23.1"
+ "@esbuild/android-arm64" "0.23.1"
+ "@esbuild/android-x64" "0.23.1"
+ "@esbuild/darwin-arm64" "0.23.1"
+ "@esbuild/darwin-x64" "0.23.1"
+ "@esbuild/freebsd-arm64" "0.23.1"
+ "@esbuild/freebsd-x64" "0.23.1"
+ "@esbuild/linux-arm" "0.23.1"
+ "@esbuild/linux-arm64" "0.23.1"
+ "@esbuild/linux-ia32" "0.23.1"
+ "@esbuild/linux-loong64" "0.23.1"
+ "@esbuild/linux-mips64el" "0.23.1"
+ "@esbuild/linux-ppc64" "0.23.1"
+ "@esbuild/linux-riscv64" "0.23.1"
+ "@esbuild/linux-s390x" "0.23.1"
+ "@esbuild/linux-x64" "0.23.1"
+ "@esbuild/netbsd-x64" "0.23.1"
+ "@esbuild/openbsd-arm64" "0.23.1"
+ "@esbuild/openbsd-x64" "0.23.1"
+ "@esbuild/sunos-x64" "0.23.1"
+ "@esbuild/win32-arm64" "0.23.1"
+ "@esbuild/win32-ia32" "0.23.1"
+ "@esbuild/win32-x64" "0.23.1"
+
+escalade@^3.1.1:
+ version "3.2.0"
+ resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.2.0.tgz#011a3f69856ba189dffa7dc8fcce99d2a87903e5"
+ integrity sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==
+
+fast-deep-equal@^3.1.3:
+ version "3.1.3"
+ resolved "https://registry.yarnpkg.com/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz#3a7d56b559d6cbc3eb512325244e619a65c6c525"
+ integrity sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==
+
+fast-json-patch@^3.1.1:
+ version "3.1.1"
+ resolved "https://registry.yarnpkg.com/fast-json-patch/-/fast-json-patch-3.1.1.tgz#85064ea1b1ebf97a3f7ad01e23f9337e72c66947"
+ integrity sha512-vf6IHUX2SBcA+5/+4883dsIjpBTqmfBjmYiWK1savxQmFk4JfBMLa7ynTYOs1Rolp/T1betJxHiGD3g1Mn8lUQ==
+
+fast-uri@^3.0.1:
+ version "3.0.1"
+ resolved "https://registry.yarnpkg.com/fast-uri/-/fast-uri-3.0.1.tgz#cddd2eecfc83a71c1be2cc2ef2061331be8a7134"
+ integrity sha512-MWipKbbYiYI0UC7cl8m/i/IWTqfC8YXsqjzybjddLsFjStroQzsHXkc73JutMvBiXmOvapk+axIl79ig5t55Bw==
+
+foreground-child@^3.1.0:
+ version "3.2.1"
+ resolved "https://registry.yarnpkg.com/foreground-child/-/foreground-child-3.2.1.tgz#767004ccf3a5b30df39bed90718bab43fe0a59f7"
+ integrity sha512-PXUUyLqrR2XCWICfv6ukppP96sdFwWbNEnfEMt7jNsISjMsvaLNinAHNDYyvkyU+SZG2BTSbT5NjG+vZslfGTA==
+ dependencies:
+ cross-spawn "^7.0.0"
+ signal-exit "^4.0.1"
+
+fs.realpath@^1.0.0:
+ version "1.0.0"
+ resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f"
+ integrity sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==
+
+fsevents@~2.3.3:
+ version "2.3.3"
+ resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.3.tgz#cac6407785d03675a2a5e1a5305c697b347d90d6"
+ integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==
+
+get-caller-file@^2.0.5:
+ version "2.0.5"
+ resolved "https://registry.yarnpkg.com/get-caller-file/-/get-caller-file-2.0.5.tgz#4f94412a82db32f36e3b0b9741f8a97feb031f7e"
+ integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==
+
+get-tsconfig@^4.7.5:
+ version "4.8.1"
+ resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.8.1.tgz#8995eb391ae6e1638d251118c7b56de7eb425471"
+ integrity sha512-k9PN+cFBmaLWtVz29SkUoqU5O0slLuHJXt/2P+tMVFT+phsSGXGkp9t3rQIqdz0e+06EHNGs3oM6ZX1s2zHxRg==
+ dependencies:
+ resolve-pkg-maps "^1.0.0"
+
+glob@^11.0.0:
+ version "11.0.0"
+ resolved "https://registry.yarnpkg.com/glob/-/glob-11.0.0.tgz#6031df0d7b65eaa1ccb9b29b5ced16cea658e77e"
+ integrity sha512-9UiX/Bl6J2yaBbxKoEBRm4Cipxgok8kQYcOPEhScPwebu2I0HoQOuYdIO6S3hLuWoZgpDpwQZMzTFxgpkyT76g==
+ dependencies:
+ foreground-child "^3.1.0"
+ jackspeak "^4.0.1"
+ minimatch "^10.0.0"
+ minipass "^7.1.2"
+ package-json-from-dist "^1.0.0"
+ path-scurry "^2.0.0"
+
+glob@^7.1.7:
+ version "7.2.3"
+ resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.3.tgz#b8df0fb802bbfa8e89bd1d938b4e16578ed44f2b"
+ integrity sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==
+ dependencies:
+ fs.realpath "^1.0.0"
+ inflight "^1.0.4"
+ inherits "2"
+ minimatch "^3.1.1"
+ once "^1.3.0"
+ path-is-absolute "^1.0.0"
+
+inflight@^1.0.4:
+ version "1.0.6"
+ resolved "https://registry.yarnpkg.com/inflight/-/inflight-1.0.6.tgz#49bd6331d7d02d0c09bc910a1075ba8165b56df9"
+ integrity sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==
+ dependencies:
+ once "^1.3.0"
+ wrappy "1"
+
+inherits@2:
+ version "2.0.4"
+ resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.4.tgz#0fa2c64f932917c3433a0ded55363aae37416b7c"
+ integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
+
+is-fullwidth-code-point@^3.0.0:
+ version "3.0.0"
+ resolved "https://registry.yarnpkg.com/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz#f116f8064fe90b3f7844a38997c0b75051269f1d"
+ integrity sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==
+
+isexe@^2.0.0:
+ version "2.0.0"
+ resolved "https://registry.yarnpkg.com/isexe/-/isexe-2.0.0.tgz#e8fbf374dc556ff8947a10dcb0572d633f2cfa10"
+ integrity sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==
+
+jackspeak@^4.0.1:
+ version "4.0.1"
+ resolved "https://registry.yarnpkg.com/jackspeak/-/jackspeak-4.0.1.tgz#9fca4ce961af6083e259c376e9e3541431f5287b"
+ integrity sha512-cub8rahkh0Q/bw1+GxP7aeSe29hHHn2V4m29nnDlvCdlgU+3UGxkZp7Z53jLUdpX3jdTO0nJZUDl3xvbWc2Xog==
+ dependencies:
+ "@isaacs/cliui" "^8.0.2"
+ optionalDependencies:
+ "@pkgjs/parseargs" "^0.11.0"
+
+json-schema-traverse@^1.0.0:
+ version "1.0.0"
+ resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz#ae7bcb3656ab77a73ba5c49bf654f38e6b6860e2"
+ integrity sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==
+
+lru-cache@^11.0.0:
+ version "11.0.0"
+ resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-11.0.0.tgz#15d93a196f189034d7166caf9fe55e7384c98a21"
+ integrity sha512-Qv32eSV1RSCfhY3fpPE2GNZ8jgM9X7rdAfemLWqTUxwiyIC4jJ6Sy0fZ8H+oLWevO6i4/bizg7c8d8i6bxrzbA==
+
+make-error@^1.1.1:
+ version "1.3.6"
+ resolved "https://registry.yarnpkg.com/make-error/-/make-error-1.3.6.tgz#2eb2e37ea9b67c4891f684a1394799af484cf7a2"
+ integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==
+
+minimatch@^10.0.0:
+ version "10.0.1"
+ resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-10.0.1.tgz#ce0521856b453c86e25f2c4c0d03e6ff7ddc440b"
+ integrity sha512-ethXTt3SGGR+95gudmqJ1eNhRO7eGEGIgYA9vnPatK4/etz2MEVDno5GMCibdMTuBMyElzIlgxMna3K94XDIDQ==
+ dependencies:
+ brace-expansion "^2.0.1"
+
+minimatch@^3.1.1:
+ version "3.1.2"
+ resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.1.2.tgz#19cd194bfd3e428f049a70817c038d89ab4be35b"
+ integrity sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==
+ dependencies:
+ brace-expansion "^1.1.7"
+
+minipass@^7.1.2:
+ version "7.1.2"
+ resolved "https://registry.yarnpkg.com/minipass/-/minipass-7.1.2.tgz#93a9626ce5e5e66bd4db86849e7515e92340a707"
+ integrity sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==
+
+once@^1.3.0:
+ version "1.4.0"
+ resolved "https://registry.yarnpkg.com/once/-/once-1.4.0.tgz#583b1aa775961d4b113ac17d9c50baef9dd76bd1"
+ integrity sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==
+ dependencies:
+ wrappy "1"
+
+package-json-from-dist@^1.0.0:
+ version "1.0.0"
+ resolved "https://registry.yarnpkg.com/package-json-from-dist/-/package-json-from-dist-1.0.0.tgz#e501cd3094b278495eb4258d4c9f6d5ac3019f00"
+ integrity sha512-dATvCeZN/8wQsGywez1mzHtTlP22H8OEfPrVMLNr4/eGa+ijtLn/6M5f0dY8UKNrC2O9UCU6SSoG3qRKnt7STw==
+
+path-equal@^1.2.5:
+ version "1.2.5"
+ resolved "https://registry.yarnpkg.com/path-equal/-/path-equal-1.2.5.tgz#9fcbdd5e5daee448e96f43f3bac06c666b5e982a"
+ integrity sha512-i73IctDr3F2W+bsOWDyyVm/lqsXO47aY9nsFZUjTT/aljSbkxHxxCoyZ9UUrM8jK0JVod+An+rl48RCsvWM+9g==
+
+path-is-absolute@^1.0.0:
+ version "1.0.1"
+ resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f"
+ integrity sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==
+
+path-key@^3.1.0:
+ version "3.1.1"
+ resolved "https://registry.yarnpkg.com/path-key/-/path-key-3.1.1.tgz#581f6ade658cbba65a0d3380de7753295054f375"
+ integrity sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==
+
+path-scurry@^2.0.0:
+ version "2.0.0"
+ resolved "https://registry.yarnpkg.com/path-scurry/-/path-scurry-2.0.0.tgz#9f052289f23ad8bf9397a2a0425e7b8615c58580"
+ integrity sha512-ypGJsmGtdXUOeM5u93TyeIEfEhM6s+ljAhrk5vAvSx8uyY/02OvrZnA0YNGUrPXfpJMgI1ODd3nwz8Npx4O4cg==
+ dependencies:
+ lru-cache "^11.0.0"
+ minipass "^7.1.2"
+
+require-directory@^2.1.1:
+ version "2.1.1"
+ resolved "https://registry.yarnpkg.com/require-directory/-/require-directory-2.1.1.tgz#8c64ad5fd30dab1c976e2344ffe7f792a6a6df42"
+ integrity sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==
+
+require-from-string@^2.0.2:
+ version "2.0.2"
+ resolved "https://registry.yarnpkg.com/require-from-string/-/require-from-string-2.0.2.tgz#89a7fdd938261267318eafe14f9c32e598c36909"
+ integrity sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==
+
+resolve-pkg-maps@^1.0.0:
+ version "1.0.0"
+ resolved "https://registry.yarnpkg.com/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz#616b3dc2c57056b5588c31cdf4b3d64db133720f"
+ integrity sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==
+
+safe-stable-stringify@^2.2.0:
+ version "2.5.0"
+ resolved "https://registry.yarnpkg.com/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz#4ca2f8e385f2831c432a719b108a3bf7af42a1dd"
+ integrity sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==
+
+shebang-command@^2.0.0:
+ version "2.0.0"
+ resolved "https://registry.yarnpkg.com/shebang-command/-/shebang-command-2.0.0.tgz#ccd0af4f8835fbdc265b82461aaf0c36663f34ea"
+ integrity sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==
+ dependencies:
+ shebang-regex "^3.0.0"
+
+shebang-regex@^3.0.0:
+ version "3.0.0"
+ resolved "https://registry.yarnpkg.com/shebang-regex/-/shebang-regex-3.0.0.tgz#ae16f1644d873ecad843b0307b143362d4c42172"
+ integrity sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==
+
+signal-exit@^4.0.1:
+ version "4.1.0"
+ resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-4.1.0.tgz#952188c1cbd546070e2dd20d0f41c0ae0530cb04"
+ integrity sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==
+
+"string-width-cjs@npm:string-width@^4.2.0":
+ version "4.2.3"
+ resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
+ integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
+ dependencies:
+ emoji-regex "^8.0.0"
+ is-fullwidth-code-point "^3.0.0"
+ strip-ansi "^6.0.1"
+
+string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.3:
+ version "4.2.3"
+ resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010"
+ integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==
+ dependencies:
+ emoji-regex "^8.0.0"
+ is-fullwidth-code-point "^3.0.0"
+ strip-ansi "^6.0.1"
+
+string-width@^5.0.1, string-width@^5.1.2:
+ version "5.1.2"
+ resolved "https://registry.yarnpkg.com/string-width/-/string-width-5.1.2.tgz#14f8daec6d81e7221d2a357e668cab73bdbca794"
+ integrity sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==
+ dependencies:
+ eastasianwidth "^0.2.0"
+ emoji-regex "^9.2.2"
+ strip-ansi "^7.0.1"
+
+"strip-ansi-cjs@npm:strip-ansi@^6.0.1":
+ version "6.0.1"
+ resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
+ integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
+ dependencies:
+ ansi-regex "^5.0.1"
+
+strip-ansi@^6.0.0, strip-ansi@^6.0.1:
+ version "6.0.1"
+ resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9"
+ integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==
+ dependencies:
+ ansi-regex "^5.0.1"
+
+strip-ansi@^7.0.1:
+ version "7.1.0"
+ resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-7.1.0.tgz#d5b6568ca689d8561370b0707685d22434faff45"
+ integrity sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==
+ dependencies:
+ ansi-regex "^6.0.1"
+
+ts-node@^10.9.1:
+ version "10.9.2"
+ resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-10.9.2.tgz#70f021c9e185bccdca820e26dc413805c101c71f"
+ integrity sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==
+ dependencies:
+ "@cspotcode/source-map-support" "^0.8.0"
+ "@tsconfig/node10" "^1.0.7"
+ "@tsconfig/node12" "^1.0.7"
+ "@tsconfig/node14" "^1.0.0"
+ "@tsconfig/node16" "^1.0.2"
+ acorn "^8.4.1"
+ acorn-walk "^8.1.1"
+ arg "^4.1.0"
+ create-require "^1.1.0"
+ diff "^4.0.1"
+ make-error "^1.1.1"
+ v8-compile-cache-lib "^3.0.1"
+ yn "3.1.1"
+
+tsx@^4.19.1:
+ version "4.19.1"
+ resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.19.1.tgz#b7bffdf4b565813e4dea14b90872af279cd0090b"
+ integrity sha512-0flMz1lh74BR4wOvBjuh9olbnwqCPc35OOlfyzHba0Dc+QNUeWX/Gq2YTbnwcWPO3BMd8fkzRVrHcsR+a7z7rA==
+ dependencies:
+ esbuild "~0.23.0"
+ get-tsconfig "^4.7.5"
+ optionalDependencies:
+ fsevents "~2.3.3"
+
+typescript-json-schema@^0.65.1:
+ version "0.65.1"
+ resolved "https://registry.yarnpkg.com/typescript-json-schema/-/typescript-json-schema-0.65.1.tgz#24840812f69b220b75d86ed87e220b3b3345db2c"
+ integrity sha512-tuGH7ff2jPaUYi6as3lHyHcKpSmXIqN7/mu50x3HlYn0EHzLpmt3nplZ7EuhUkO0eqDRc9GqWNkfjgBPIS9kxg==
+ dependencies:
+ "@types/json-schema" "^7.0.9"
+ "@types/node" "^18.11.9"
+ glob "^7.1.7"
+ path-equal "^1.2.5"
+ safe-stable-stringify "^2.2.0"
+ ts-node "^10.9.1"
+ typescript "~5.5.0"
+ yargs "^17.1.1"
+
+typescript@^5.6.2:
+ version "5.6.2"
+ resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.6.2.tgz#d1de67b6bef77c41823f822df8f0b3bcff60a5a0"
+ integrity sha512-NW8ByodCSNCwZeghjN3o+JX5OFH0Ojg6sadjEKY4huZ52TqbJTJnDo5+Tw98lSy63NZvi4n+ez5m2u5d4PkZyw==
+
+typescript@~5.5.0:
+ version "5.5.4"
+ resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.5.4.tgz#d9852d6c82bad2d2eda4fd74a5762a8f5909e9ba"
+ integrity sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==
+
+undici-types@~5.26.4:
+ version "5.26.5"
+ resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-5.26.5.tgz#bcd539893d00b56e964fd2657a4866b221a65617"
+ integrity sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==
+
+v8-compile-cache-lib@^3.0.1:
+ version "3.0.1"
+ resolved "https://registry.yarnpkg.com/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz#6336e8d71965cb3d35a1bbb7868445a7c05264bf"
+ integrity sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==
+
+which@^2.0.1:
+ version "2.0.2"
+ resolved "https://registry.yarnpkg.com/which/-/which-2.0.2.tgz#7c6a8dd0a636a0327e10b59c9286eee93f3f51b1"
+ integrity sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==
+ dependencies:
+ isexe "^2.0.0"
+
+"wrap-ansi-cjs@npm:wrap-ansi@^7.0.0":
+ version "7.0.0"
+ resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
+ integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
+ dependencies:
+ ansi-styles "^4.0.0"
+ string-width "^4.1.0"
+ strip-ansi "^6.0.0"
+
+wrap-ansi@^7.0.0:
+ version "7.0.0"
+ resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
+ integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==
+ dependencies:
+ ansi-styles "^4.0.0"
+ string-width "^4.1.0"
+ strip-ansi "^6.0.0"
+
+wrap-ansi@^8.1.0:
+ version "8.1.0"
+ resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-8.1.0.tgz#56dc22368ee570face1b49819975d9b9a5ead214"
+ integrity sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==
+ dependencies:
+ ansi-styles "^6.1.0"
+ string-width "^5.0.1"
+ strip-ansi "^7.0.1"
+
+wrappy@1:
+ version "1.0.2"
+ resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f"
+ integrity sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==
+
+y18n@^5.0.5:
+ version "5.0.8"
+ resolved "https://registry.yarnpkg.com/y18n/-/y18n-5.0.8.tgz#7f4934d0f7ca8c56f95314939ddcd2dd91ce1d55"
+ integrity sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==
+
+yargs-parser@^21.1.1:
+ version "21.1.1"
+ resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35"
+ integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==
+
+yargs@^17.1.1:
+ version "17.7.2"
+ resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.7.2.tgz#991df39aca675a192b816e1e0363f9d75d2aa269"
+ integrity sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==
+ dependencies:
+ cliui "^8.0.1"
+ escalade "^3.1.1"
+ get-caller-file "^2.0.5"
+ require-directory "^2.1.1"
+ string-width "^4.2.3"
+ y18n "^5.0.5"
+ yargs-parser "^21.1.1"
+
+yn@3.1.1:
+ version "3.1.1"
+ resolved "https://registry.yarnpkg.com/yn/-/yn-3.1.1.tgz#1e87401a09d767c1d5eab26a6e4c185182d2eb50"
+ integrity sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==