mcp-openapi-schema-explorer 1.2.1 → 1.3.0

package/.github/dependabot.yml

@@ -5,9 +5,21 @@ updates:
     schedule:
       interval: 'weekly'
     open-pull-requests-limit: 10
+    groups:
+      # Group all development dependencies together
+      dev-dependencies:
+        dependency-type: 'development'
+
+      # Group production dependencies together
+      production-dependencies:
+        dependency-type: 'production'
 
   - package-ecosystem: 'github-actions'
     directory: '/'
     schedule:
       interval: 'weekly'
     open-pull-requests-limit: 10
+    groups:
+      github-actions:
+        patterns:
+          - '*'

package/.tokeignore

@@ -0,0 +1 @@
+package-lock.json

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+# [1.3.0](https://github.com/kadykov/mcp-openapi-schema-explorer/compare/v1.2.1...v1.3.0) (2025-08-12)
+
+### Bug Fixes
+
+- Use more generic instructions ([1372aae](https://github.com/kadykov/mcp-openapi-schema-explorer/commit/1372aaea824f2b9eb5d4c3569acc4f38c82550fd))
+
+### Features
+
+- add brief instructions so LLMs can better understand how to use the server ([c55c4ec](https://github.com/kadykov/mcp-openapi-schema-explorer/commit/c55c4ec029a7603746bf506340d8e3ffd54a6532))
+
 ## [1.2.1](https://github.com/kadykov/mcp-openapi-schema-explorer/compare/v1.2.0...v1.2.1) (2025-04-13)
 
 ### Bug Fixes

package/DOCKERHUB_README.md

@@ -0,0 +1,126 @@
+# MCP OpenAPI Schema Explorer
+
+[![Docker Pulls](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer)
+[![GitHub Repo](https://img.shields.io/badge/GitHub-kadykov/mcp--openapi--schema--explorer-blue?logo=github)](https://github.com/kadykov/mcp-openapi-schema-explorer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+This Docker image runs the **MCP OpenAPI Schema Explorer**, an MCP (Model Context Protocol) server that provides token-efficient access to OpenAPI (v3.0) and Swagger (v2.0) specifications via **MCP Resources**.
+
+It allows MCP clients (like Cline or Claude Desktop) to explore the structure and details of large OpenAPI specifications without needing to load the entire file into an LLM's context window.
+
+**Source Code & Full Documentation:** [https://github.com/kadykov/mcp-openapi-schema-explorer](https://github.com/kadykov/mcp-openapi-schema-explorer)
+
+## Features
+
+- **MCP Resource Access:** Explore OpenAPI specs via intuitive URIs (`openapi://info`, `openapi://paths/...`, `openapi://components/...`).
+- **OpenAPI v3.0 & Swagger v2.0 Support:** Loads both formats, automatically converting v2.0 to v3.0.
+- **Local & Remote Files:** Load specs from local file paths (via volume mount) or HTTP/HTTPS URLs.
+- **Token-Efficient:** Designed to minimize token usage for LLMs.
+- **Multiple Output Formats:** Get detailed views in JSON (default), YAML, or minified JSON (`--output-format`).
+- **Dynamic Server Name:** Server name in MCP clients reflects the `info.title` from the loaded spec.
+- **Reference Transformation:** Internal `$ref`s (`#/components/...`) are transformed into clickable MCP URIs.
+
+## How to Run
+
+Pull the image:
+
+```bash
+docker pull kadykov/mcp-openapi-schema-explorer:latest
+```
+
+The container expects the path or URL to the OpenAPI specification as a command-line argument.
+
+### Using a Remote Specification URL
+
+Pass the URL directly to `docker run`:
+
+```bash
+docker run --rm -i kadykov/mcp-openapi-schema-explorer:latest https://petstore3.swagger.io/api/v3/openapi.json
+```
+
+### Using a Local Specification File
+
+Mount your local file into the container using the `-v` flag and provide the path _inside the container_ as the argument:
+
+```bash
+# Example: Mount local file ./my-spec.yaml to /spec/api.yaml inside the container
+docker run --rm -i -v "$(pwd)/my-spec.yaml:/spec/api.yaml" kadykov/mcp-openapi-schema-explorer:latest /spec/api.yaml
+```
+
+_(Note: Replace `$(pwd)/my-spec.yaml` with the actual absolute path to your local file on the host machine)_
+
+### Specifying Output Format
+
+Use the `--output-format` flag (optional, defaults to `json`):
+
+```bash
+# Using YAML output with a remote URL
+docker run --rm -i kadykov/mcp-openapi-schema-explorer:latest https://petstore3.swagger.io/api/v3/openapi.json --output-format yaml
+
+# Using minified JSON with a local file
+docker run --rm -i -v "$(pwd)/my-spec.yaml:/spec/api.yaml" kadykov/mcp-openapi-schema-explorer:latest /spec/api.yaml --output-format json-minified
+```
+
+Supported formats: `json`, `yaml`, `json-minified`.
+
+## Tags
+
+- `latest`: Points to the most recent stable release.
+- Specific version tags (e.g., `1.2.1`) are available corresponding to the npm package versions.
+
+## Usage with MCP Clients
+
+You can configure your MCP client (like Cline or Claude Desktop) to run this Docker image as an MCP server.
+
+### Example: Remote URL Specification
+
+```json
+// Example: ~/.config/cline/mcp_config.json
+{
+  "mcpServers": {
+    "My API Spec (Docker Remote)": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "-i", // Required for MCP communication
+        "kadykov/mcp-openapi-schema-explorer:latest",
+        "https://petstore3.swagger.io/api/v3/openapi.json"
+        // Optional: Add "--output-format", "yaml" here if needed
+      ],
+      "env": {}
+    }
+  }
+}
+```
+
+### Example: Local File Specification
+
+```json
+// Example: ~/.config/cline/mcp_config.json
+{
+  "mcpServers": {
+    "My API Spec (Docker Local)": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "-i", // Required for MCP communication
+        "-v",
+        "/full/path/to/your/local/openapi.yaml:/spec/api.yaml", // Host path : Container path
+        "kadykov/mcp-openapi-schema-explorer:latest",
+        "/spec/api.yaml", // Path inside the container
+        "--output-format",
+        "yaml" // Optional format
+      ],
+      "env": {}
+    }
+  }
+}
+```
+
+_(Remember to replace `/full/path/to/your/local/openapi.yaml` with the correct absolute path on your host machine)_
+
+## Support
+
+For issues or questions, please refer to the [GitHub repository](https://github.com/kadykov/mcp-openapi-schema-explorer) or open an [issue](https://github.com/kadykov/mcp-openapi-schema-explorer/issues).

package/README.md

@@ -1,8 +1,16 @@
+<p align="center">
+  <img src="assets/logo-400.png" alt="MCP OpenAPI Schema Explorer Logo" width="200">
+</p>
+
 # MCP OpenAPI Schema Explorer
 
 [![npm version](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer)
+[![NPM Downloads](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer)
+[![Docker Pulls](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![codecov](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer)
+[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)
+[![](https://tokei.rs/b1/github/kadykov/mcp-openapi-schema-explorer?category=code)](https://github.com/kadykov/mcp-openapi-schema-explorer)
 
 An MCP (Model Context Protocol) server that provides token-efficient access to OpenAPI (v3.0) and Swagger (v2.0) specifications via **MCP Resources**.
 
@@ -23,21 +31,52 @@ While other MCP servers exist that provide access to OpenAPI specs via _Tools_,
 
 For more details on MCP clients and their capabilities, see the [MCP Client Documentation](https://modelcontextprotocol.io/clients).
 
-## Usage with MCP Clients (Recommended)
+## Installation
+
+For the recommended usage methods (`npx` and Docker, described below), **no separate installation step is required**. Your MCP client will download the package or pull the Docker image automatically based on the configuration you provide.
+
+However, if you prefer or need to install the server explicitly, you have two options:
+
+1.  **Global Installation:** You can install the package globally using npm:
+
+    ```bash
+    npm install -g mcp-openapi-schema-explorer
+    ```
+
+    See **Method 3** below for how to configure your MCP client to use a globally installed server.
+
+2.  **Local Development/Installation:** You can clone the repository and build it locally:
+    ```bash
+    git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git
+    cd mcp-openapi-schema-explorer
+    npm install
+    npm run build
+    ```
+    See **Method 4** below for how to configure your MCP client to run the server from your local build using `node`.
 
-This server is designed to be run by MCP clients. The recommended way to configure it is using `npx`, which downloads and runs the package without requiring a global installation.
+## Adding the Server to your MCP Client
 
-**Example Configuration (Claude Desktop - `claude_desktop_config.json`):**
+This server is designed to be run by MCP clients (like Claude Desktop, Windsurf, Cline, etc.). To use it, you add a configuration entry to your client's settings file (often a JSON file). This entry tells the client how to execute the server process (e.g., using `npx`, `docker`, or `node`). The server itself doesn't require separate configuration beyond the command-line arguments specified in the client settings entry.
+
+Below are the common methods for adding the server entry to your client's configuration.
+
+### Method 1: npx (Recommended)
+
+Using `npx` is recommended as it avoids global/local installation and ensures the client uses the latest published version.
+
+**Example Client Configuration Entry (npx Method):**
+
+Add the following JSON object to the `mcpServers` section of your MCP client's configuration file. This entry instructs the client on how to run the server using `npx`:
 
 ```json
 {
   "mcpServers": {
-    "My API Spec": {
+    "My API Spec (npx)": {
       "command": "npx",
       "args": [
         "-y",
-        "mcp-openapi-schema-explorer",
-        "/path/to/your/local/openapi.json",
+        "mcp-openapi-schema-explorer@latest",
+        "<path-or-url-to-spec>",
         "--output-format",
         "yaml"
       ],
@@ -47,53 +86,23 @@ This server is designed to be run by MCP clients. The recommended way to configu
 }
 ```
 
-**Configuration Details:**
-
-- **`"My API Spec"`:** Choose a descriptive name for this server instance. This is how you'll identify it within your MCP client.
-- **`command`:** Use `"npx"` to run the package directly.
-- **`args`:**
-  - `"-y"`: Auto-confirms the `npx` installation prompt if needed the first time.
-  - `"mcp-openapi-schema-explorer"`: The name of the package to execute.
-  - `"/path/to/your/local/openapi.json"`: **Required.** The absolute path to your local spec file or the full URL to a remote spec (e.g., `"https://remote/url/spec.json"`).
-  - `"--output-format", "yaml"`: **Optional.** Specifies the output format for detailed resource views. Defaults to `"json"`. Other options are `"yaml"` and `"json-minified"`.
-- **`env`:** Currently, no environment variables are needed for this server.
-
-**Notes:**
+**Configuration Notes:**
 
-- This server handles one specification per instance. To explore multiple specifications simultaneously, configure multiple entries under `mcpServers` in your client's configuration file, each pointing to a different spec file or URL and using a unique server name.
+- Replace `"My API Spec (npx)"` with a unique name for this server instance in your client.
+- Replace `<path-or-url-to-spec>` with the absolute local file path or full remote URL of your specification.
+- The `--output-format` is optional (`json`, `yaml`, `json-minified`), defaulting to `json`.
+- To explore multiple specifications, add separate entries in `mcpServers`, each with a unique name and pointing to a different spec.
 
-## Usage with Docker
+### Method 2: Docker
 
-As an alternative to `npx` or global installation, you can run the server using Docker. The official image is available on Docker Hub: `kadykov/mcp-openapi-schema-explorer`.
+You can instruct your MCP client to run the server using the official Docker image: `kadykov/mcp-openapi-schema-explorer`.
 
-**Running the Container:**
+**Example Client Configuration Entries (Docker Method):**
 
-The container expects the path or URL to the OpenAPI specification as a command-line argument, similar to the `npx` usage.
+Add one of the following JSON objects to the `mcpServers` section of your MCP client's configuration file. These entries instruct the client on how to run the server using `docker run`:
 
 - **Remote URL:** Pass the URL directly to `docker run`.
 
-  ```bash
-  docker run --rm -i kadykov/mcp-openapi-schema-explorer:latest https://petstore3.swagger.io/api/v3/openapi.json
-  ```
-
-- **Local File:** Mount the local file into the container using the `-v` flag and provide the path _inside the container_ as the argument.
-
-  ```bash
-  # Example: Mount local file ./my-spec.yaml to /spec/api.yaml inside the container
-  docker run --rm -i -v "$(pwd)/my-spec.yaml:/spec/api.yaml" kadykov/mcp-openapi-schema-explorer:latest /spec/api.yaml
-  ```
-
-  _(Note: Replace `$(pwd)/my-spec.yaml` with the actual path to your local file)_
-
-- **Output Format:** You can still use the `--output-format` flag:
-  ```bash
-  docker run --rm -i kadykov/mcp-openapi-schema-explorer:latest https://petstore3.swagger.io/api/v3/openapi.json --output-format yaml
-  ```
-
-**Example MCP Client Configuration (Docker):**
-
-Here's how you might configure this in a client like Claude Desktop (`claude_desktop_config.json`):
-
 - **Using a Remote URL:**
 
   ```json
@@ -106,7 +115,7 @@ Here's how you might configure this in a client like Claude Desktop (`claude_des
           "--rm",
           "-i",
           "kadykov/mcp-openapi-schema-explorer:latest",
-          "https://petstore3.swagger.io/api/v3/openapi.json"
+          "<remote-url-to-spec>"
         ],
         "env": {}
       }
@@ -114,7 +123,7 @@ Here's how you might configure this in a client like Claude Desktop (`claude_des
   }
   ```
 
-- **Using a Local File:**
+- **Using a Local File:** (Requires mounting the file into the container)
   ```json
   {
     "mcpServers": {
@@ -125,7 +134,7 @@ Here's how you might configure this in a client like Claude Desktop (`claude_des
           "--rm",
           "-i",
           "-v",
-          "/full/path/to/your/local/openapi.yaml:/spec/api.yaml",
+          "/full/host/path/to/spec.yaml:/spec/api.yaml",
           "kadykov/mcp-openapi-schema-explorer:latest",
           "/spec/api.yaml",
           "--output-format",
@@ -136,20 +145,69 @@ Here's how you might configure this in a client like Claude Desktop (`claude_des
     }
   }
   ```
-  _(Remember to replace `/full/path/to/your/local/openapi.yaml` with the correct absolute path on your host machine)_
+  **Important:** Replace `/full/host/path/to/spec.yaml` with the correct absolute path on your host machine. The path `/spec/api.yaml` is the corresponding path inside the container.
 
-## Alternative: Global Installation (Less Common)
+### Method 3: Global Installation (Less Common)
 
-If you prefer, you can install the server globally:
+If you have installed the package globally using `npm install -g`, you can configure your client to run it directly.
 
 ```bash
+# Run this command once in your terminal
 npm install -g mcp-openapi-schema-explorer
 ```
 
-If installed globally, your MCP client configuration would change:
+**Example Client Configuration Entry (Global Install Method):**
+
+Add the following entry to your MCP client's configuration file. This assumes the `mcp-openapi-schema-explorer` command is accessible in the client's execution environment PATH.
+
+```json
+{
+  "mcpServers": {
+    "My API Spec (Global)": {
+      "command": "mcp-openapi-schema-explorer",
+      "args": ["<path-or-url-to-spec>", "--output-format", "yaml"],
+      "env": {}
+    }
+  }
+}
+```
+
+- Ensure the `command` (`mcp-openapi-schema-explorer`) is accessible in the PATH environment variable used by your MCP client.
+
+### Method 4: Local Development/Installation
+
+This method is useful if you have cloned the repository locally for development or to run a modified version.
+
+**Setup Steps (Run once in your terminal):**
+
+1.  Clone the repository: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`
+2.  Navigate into the directory: `cd mcp-openapi-schema-explorer`
+3.  Install dependencies: `npm install`
+4.  Build the project: `npm run build` (or `just build`)
+
+**Example Client Configuration Entry (Local Development Method):**
+
+Add the following entry to your MCP client's configuration file. This instructs the client to run the locally built server using `node`.
+
+```json
+{
+  "mcpServers": {
+    "My API Spec (Local Dev)": {
+      "command": "node",
+      "args": [
+        "/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js",
+        "<path-or-url-to-spec>",
+        "--output-format",
+        "yaml"
+      ],
+
+      "env": {}
+    }
+  }
+}
+```
 
-- `command`: Likely `mcp-openapi-schema-explorer` (or the full path if needed).
-- `args`: Would only contain the `<path-or-url-to-spec>` and optional `--output-format` flag (omit `npx` and `-y`).
+**Important:** Replace `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` with the correct absolute path to the built `index.js` file in your cloned repository.
 
 ## Features
 

package/dist/src/index.js

@@ -42,10 +42,14 @@ async function main() {
         const serverName = spec.info?.title
             ? `Schema Explorer for ${spec.info.title}`
             : defaultServerName;
+        // Brief help content for LLMs
+        const helpContent = `Use resorces/templates/list to get a list of available resources. Use openapi://paths to get a list of all endpoints.`;
         // Create MCP server with dynamic name
         const server = new McpServer({
             name: serverName,
             version: VERSION, // Use the imported version
+        }, {
+            instructions: helpContent,
         });
         // Set up formatter and new handlers
         const formatter = createFormatter(config.outputFormat);

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.2.1";
+export declare const VERSION = "1.3.0";

package/dist/src/version.js

@@ -1,4 +1,4 @@
 // Auto-generated by scripts/generate-version.js during semantic-release prepare step
 // Do not edit this file manually.
-export const VERSION = '1.2.1';
+export const VERSION = '1.3.0';
 //# sourceMappingURL=version.js.map

package/justfile

@@ -30,7 +30,7 @@ type-check:
 
 # Security scan dependencies for vulnerabilities
 audit:
-    npm audit
+    npm audit --audit-level=high
 
 # Check license compliance
 check-licenses:

package/llms-install.md

@@ -0,0 +1,210 @@
+# MCP OpenAPI Schema Explorer Usage Guide
+
+This guide explains how to add the MCP OpenAPI Schema Explorer server to your MCP client (e.g., Claude Desktop, Windsurf, Cline). This involves adding a configuration entry to your client's settings file that tells the client how to run the server process. The server itself doesn't require separate configuration beyond the command-line arguments specified in the client settings.
+
+## Prerequisites
+
+1.  Node.js (Latest LTS version recommended) OR Docker installed.
+2.  Access to an OpenAPI v3.0 or Swagger v2.0 specification file, either via a local file path or a remote HTTP/HTTPS URL.
+3.  An MCP client application (e.g., Claude Desktop, Windsurf, Cline, etc.).
+
+## Installation
+
+For the recommended usage methods (`npx` and Docker, described below), **no separate installation step is required**. Your MCP client will download the package or pull the Docker image automatically based on the configuration you provide in its settings.
+
+If you prefer to install the server explicitly:
+
+- **Global Install:** Run `npm install -g mcp-openapi-schema-explorer`. See **Usage Method 3** for how to configure your client to use this.
+- **Local Install (for Development):** Clone the repository (`git clone ...`), install dependencies (`npm install`), and build (`npm run build`). See **Usage Method 4** for how to configure your client to use this.
+
+## Usage Method 1: npx (Recommended)
+
+This is the recommended method as it avoids global/local installation and ensures you use the latest published version.
+
+### Client Configuration Entry (npx Method)
+
+Add the following JSON object to the `mcpServers` section of your MCP client's configuration file (e.g., `claude_desktop_config.json`). This entry instructs the client on how to run the server using `npx`:
+
+```json
+{
+  "mcpServers": {
+    "My API Spec (npx)": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-openapi-schema-explorer@latest",
+        "<path-or-url-to-spec>",
+        "--output-format",
+        "yaml"
+      ],
+      "env": {}
+    }
+  }
+}
+```
+
+**Configuration Details:**
+
+1.  **Replace `"My API Spec (npx)"`:** Choose a descriptive name for this server instance.
+2.  **Replace `<path-or-url-to-spec>`:** Provide the **required** absolute local file path (e.g., `/path/to/your/api.yaml`) or the full remote URL (e.g., `https://petstore3.swagger.io/api/v3/openapi.json`).
+3.  **(Optional)** Adjust the `--output-format` value (`yaml`, `json`, `json-minified`). Defaults to `json`.
+
+## Usage Method 2: Docker
+
+You can instruct your MCP client to run the server using the official Docker image: `kadykov/mcp-openapi-schema-explorer`.
+
+### Client Configuration Entry (Docker Method)
+
+- **Using a Remote URL:**
+
+  ```json
+  {
+    "mcpServers": {
+      "My API Spec (Docker Remote)": {
+        "command": "docker",
+        "args": [
+          "run",
+          "--rm",
+          "-i",
+          "kadykov/mcp-openapi-schema-explorer:latest",
+          "<remote-url-to-spec>"
+        ],
+        "env": {}
+      }
+    }
+  }
+  ```
+
+- **Using a Local File:** (Requires mounting the file into the container)
+  ```json
+  {
+    "mcpServers": {
+      "My API Spec (Docker Local)": {
+        "command": "docker",
+        "args": [
+          "run",
+          "--rm",
+          "-i",
+          "-v",
+          "/full/host/path/to/spec.yaml:/spec/api.yaml",
+          "kadykov/mcp-openapi-schema-explorer:latest",
+          "/spec/api.yaml",
+          "--output-format",
+          "yaml"
+        ],
+        "env": {}
+      }
+    }
+  }
+  ```
+  **Important:** Replace `/full/host/path/to/spec.yaml` with the correct absolute path on your host machine. The path `/spec/api.yaml` is the corresponding path inside the container.
+
+## Usage Method 3: Global Installation (Less Common)
+
+You can install the package globally, although `npx` is generally preferred.
+
+```bash
+# Run this command once in your terminal
+npm install -g mcp-openapi-schema-explorer
+```
+
+### Client Configuration Entry (Global Install Method)
+
+Add the following entry to your MCP client's configuration file. This assumes the `mcp-openapi-schema-explorer` command is accessible in the client's execution environment PATH.
+
+```json
+{
+  "mcpServers": {
+    "My API Spec (Global)": {
+      "command": "mcp-openapi-schema-explorer",
+      "args": ["<path-or-url-to-spec>", "--output-format", "yaml"],
+      "env": {}
+    }
+  }
+}
+```
+
+- **`command`:** Use the globally installed command name. You might need the full path if it's not in your system's PATH environment variable accessible by the MCP client.
+
+## Usage Method 4: Local Development/Installation
+
+This method is useful for development or running a locally modified version of the server.
+
+### Setup Steps (Run once in your terminal)
+
+1.  Clone the repository: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`
+2.  Navigate into the directory: `cd mcp-openapi-schema-explorer`
+3.  Install dependencies: `npm install`
+4.  Build the project: `npm run build` (or `just build`)
+
+### Client Configuration Entry (Local Development Method)
+
+Add the following entry to your MCP client's configuration file. This instructs the client to run the locally built server using `node`.
+
+```json
+{
+  "mcpServers": {
+    "My API Spec (Local Dev)": {
+      "command": "node",
+      "args": [
+        "/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js",
+        "<path-or-url-to-spec>",
+        "--output-format",
+        "yaml"
+      ],
+
+      "env": {}
+    }
+  }
+}
+```
+
+**Important:** Replace `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` with the correct absolute path to the built `index.js` file in your cloned repository.
+
+## Verification
+
+After adding the server entry to your MCP client's configuration:
+
+1.  The server should appear in the list of available MCP servers within your client (e.g., named "My API Spec (npx)" or whatever key you used). The server name might dynamically update based on the spec's `info.title` (e.g., "Schema Explorer for Petstore API").
+2.  Test the connection by accessing a basic resource, for example (using your chosen server name):
+    ```
+    /mcp "My API Spec (npx)" access openapi://info
+    ```
+
+## Troubleshooting
+
+Common issues and solutions:
+
+1.  **Server Fails to Start:**
+    - Verify the `<path-or-url-to-spec>` is correct, accessible, and properly quoted in the JSON configuration.
+    - Ensure the specification file is a valid OpenAPI v3.0 or Swagger v2.0 document (JSON or YAML).
+    - Check Node.js version (LTS recommended) if using `npx`, global, or local install.
+    - Check Docker installation and permissions if using Docker.
+    - For remote URLs, check network connectivity.
+    - For Docker with local files, ensure the volume mount path (`-v` flag) is correct and the host path exists.
+    - For Local Development, ensure the path to `dist/src/index.js` is correct and the project has been built (`npm run build`).
+2.  **Resources Not Loading or Errors:**
+    - Double-check the resource URI syntax (e.g., `openapi://paths`, `openapi://components/schemas/MySchema`). Remember that path segments in URIs need URL encoding (e.g., `/users/{id}` becomes `users%2F%7Bid%7D`).
+    - Ensure the requested path, method, or component exists in the specification.
+
+## Environment Variables
+
+No environment variables are required for the server to operate.
+
+## Additional Notes
+
+- The server automatically handles loading specs from local files or remote URLs.
+- Swagger v2.0 specifications are automatically converted to OpenAPI v3.0 internally.
+- Internal references (`#/components/...`) are transformed into clickable MCP URIs (`openapi://components/...`).
+- The server name displayed in the client might be dynamically generated from the specification's title.
+
+## Support
+
+If you encounter any issues:
+
+1.  Check the project's main README for more details: [https://github.com/kadykov/mcp-openapi-schema-explorer#readme](https://github.com/kadykov/mcp-openapi-schema-explorer#readme)
+2.  Submit an issue on GitHub: [https://github.com/kadykov/mcp-openapi-schema-explorer/issues](https://github.com/kadykov/mcp-openapi-schema-explorer/issues)
+
+---
+
+This guide provides instructions for adding the server to your MCP client using various execution methods. Refer to the main project README for comprehensive documentation on features and resource usage.

package/memory-bank/activeContext.md

@@ -2,154 +2,92 @@
 
 ## Current Focus
 
-Completed setup of automated versioning and releases using `semantic-release` and updated the CI workflow. Corrected dependency categorization in `package.json`. Updated Memory Bank.
-
-## Recent Progress
-
-### Dependency Cleanup & Release Automation (✓)
-
-1.  **Dependency Correction:**
-    - Moved `swagger2openapi` from `devDependencies` to `dependencies` in `package.json`.
-    - Moved `@types/js-yaml` from `dependencies` to `devDependencies` in `package.json`.
-    - Removed unused `@types/swagger-parser` from `devDependencies` in `package.json`.
-    - Ran `npm install` to update `package-lock.json`.
-2.  **Semantic Release Setup:**
-    - Installed `semantic-release` and plugins (`@semantic-release/commit-analyzer`, `@semantic-release/release-notes-generator`, `@semantic-release/changelog`, `@semantic-release/npm`, `@semantic-release/github`, `@semantic-release/git`, `@semantic-release/exec`) as dev dependencies.
-    - Created `scripts/generate-version.js` to write the release version to `src/version.ts`.
-    - Created `.releaserc.json` configuring the release workflow, including using `@semantic-release/exec` to run the generation script and `@semantic-release/git` to commit `src/version.ts`.
-    - Updated `eslint.config.js` to correctly lint the `generate-version.js` script.
-3.  **Dynamic Versioning:**
-    - Created a default `src/version.ts` file (with version `0.0.0-dev`) tracked by Git to ensure local/CI builds work.
-    - Updated `src/index.ts` to import `VERSION` from `src/version.ts` and use it in the `McpServer` constructor.
-    - The default `src/version.ts` will be overwritten with the correct release version by `semantic-release` during the release process.
-4.  **CI Workflow Adaptation:**
-    - Updated `.github/workflows/ci.yml`.
-    - Removed Docker Compose dependency from the `test` job.
-    - Standardized on Node 22 for `test` and `security` jobs.
-    - Added `extractions/setup-just@v3` action to both jobs.
-    - Updated `test` job to run checks via `just all`.
-    - Updated `security` job to run checks via `just security` (keeping CodeQL separate).
-    - Added a new `release` job triggered on pushes to `main` (after `test` and `security` pass) that uses `cycjimmy/semantic-release-action@v4`. Configured necessary permissions and environment variables (`GITHUB_TOKEN`, `NPM_TOKEN`).
-5.  **Memory Bank Update (✓):** Updated `activeContext.md`, `progress.md`, `systemPatterns.md`, and `techContext.md`.
-
-### Docker Support Implementation (✓)
-
-1.  **Dockerfile Strategy:**
-    - Moved existing devcontainer `Dockerfile` to `.devcontainer/Dockerfile`.
-    - Updated `.devcontainer/devcontainer.json` to reference the new path.
-    - Created a new multi-stage production `Dockerfile` at the project root (`./Dockerfile`).
-2.  **Docker Plugin:**
-    - Installed `@codedependant/semantic-release-docker` dev dependency.
-    - Configured the plugin in `.releaserc.json` to publish to `kadykov/mcp-openapi-schema-explorer` on Docker Hub, disabling the plugin's built-in login.
-3.  **CI Workflow Update (`.github/workflows/ci.yml`):**
-    - Added Docker setup steps (QEMU, Buildx, Login using `docker/login-action@v3` with `DOCKERHUB_USERNAME` var and `DOCKERHUB_TOKEN` secret) to the `release` job.
-    - Updated the `cycjimmy/semantic-release-action@v4` step to include `@codedependant/semantic-release-docker` in `extra_plugins`.
-    - Removed redundant Node.js setup and `npm ci` steps from the `release` job, as the action handles plugin installation.
-4.  **Documentation:** Updated `README.md` with a "Usage with Docker" section, including `docker run` examples and MCP client configuration examples for local and remote specs.
-
-### Dynamic Server Name (✓)
-
-1.  **Spec Loading:** Modified `src/index.ts` to load the OpenAPI spec using `createSpecLoader` _before_ initializing `McpServer`.
-2.  **Name Generation:** Extracted `info.title` from the loaded spec and constructed a dynamic server name (`Schema Explorer for {title}`) with a fallback to `'OpenAPI Schema Explorer'`.
-3.  **Server Initialization:** Updated `McpServer` constructor in `src/index.ts` to use the generated dynamic name.
-4.  **Dependency Injection:** Confirmed handlers already receive the shared `specLoader` instance correctly, requiring no changes to handler constructors.
-5.  **Memory Bank Update (✓):** Updated `activeContext.md` and `progress.md`.
-
-### Resource Completion Logic (✓)
-
-1.  **Implementation:** Modified `src/index.ts` to define `ResourceTemplate` objects directly within `server.resource()` calls. Added `complete` property with functions providing suggestions for `{field}`, `{path}`, `{method*}`, and `{type}` based on the loaded `transformedSpec`.
-2.  **Conditional Name Completion:** Implemented logic for the `{name*}` completion in the `openapi://components/{type}/{name*}` template. It now provides component names only if the spec contains exactly one component type (e.g., only `schemas`). Otherwise, it returns an empty list. Used `getValidatedComponentMap` helper for safe access.
-3.  **Testing:**
-    - Added new E2E test suite (`Completion Tests`) to `test/__tests__/e2e/resources.test.ts` using the `client.complete()` method.
-    - Added new test fixture `test/fixtures/multi-component-types.json` to cover the multi-type scenario for name completion.
-    - Verified all tests pass.
-4.  **Memory Bank Update (✓):** Updated `activeContext.md`, `progress.md`, `systemPatterns.md`, and `projectbrief.md`.
-
-### Dynamic Server Name (✓)
-
-1.  **Spec Loading:** Modified `src/index.ts` to load the OpenAPI spec using `createSpecLoader` _before_ initializing `McpServer`.
-2.  **Name Generation:** Extracted `info.title` from the loaded spec and constructed a dynamic server name (`Schema Explorer for {title}`) with a fallback to `'OpenAPI Schema Explorer'`.
-3.  **Server Initialization:** Updated `McpServer` constructor in `src/index.ts` to use the generated dynamic name.
-4.  **Dependency Injection:** Confirmed handlers already receive the shared `specLoader` instance correctly, requiring no changes to handler constructors.
-5.  **Memory Bank Update (✓):** Updated `activeContext.md` and `progress.md`.
-
-### Minified JSON Output Format (✓)
-
-1.  **Formatter:** Added `MinifiedJsonFormatter` to `src/services/formatters.ts` and updated `OutputFormat` type and `createFormatter` function.
-2.  **Configuration:** Updated `src/config.ts` to accept `--output-format json-minified`.
-3.  **Unit Tests:** Added unit tests for `MinifiedJsonFormatter` in `test/__tests__/unit/services/formatters.test.ts`.
-4.  **E2E Tests:** Added E2E tests for the `json-minified` format in `test/__tests__/e2e/format.test.ts`.
-5.  **Test Helpers:** Updated `StartServerOptions` type in `test/utils/mcp-test-helpers.ts`.
-6.  **Memory Bank Update (✓):** Updated `techContext.md`, `systemPatterns.md`, `progress.md`, and `activeContext.md`.
-
-### Remote Spec & Swagger v2.0 Support (✓)
-
-1.  **Remote Loading:** Added support for loading specifications via HTTP/HTTPS URLs using `swagger2openapi` in `SpecLoaderService`.
-2.  **Swagger v2.0 Conversion:** Added support for automatically converting Swagger v2.0 specifications to OpenAPI v3.0 using `swagger2openapi` in `SpecLoaderService`.
-3.  **Dependency Change:** Replaced `@apidevtools/swagger-parser` with `swagger2openapi`. Added `@types/swagger2openapi`. Reinstalled `openapi-types`.
-4.  **Configuration:** Confirmed configuration uses CLI arguments (`<path-or-url-to-spec>`).
-5.  **Testing:**
-    - Updated `SpecLoaderService` unit tests (`spec-loader.test.ts`) to mock `swagger2openapi` and cover new scenarios (local/remote, v2/v3). Fixed linting/hoisting issues in mocks.
-    - Created new E2E test file (`spec-loading.test.ts`) to verify loading from local v2 and remote v3 sources. Added necessary helpers and fixed linting issues.
-    - Added v2.0 test fixture (`sample-v2-api.json`).
-6.  **Memory Bank Update (✓):** Updated `productContext.md`, `techContext.md`, `systemPatterns.md`, `progress.md`, and `activeContext.md` to reflect these changes.
-
-### Major Refactor (Previously Completed - ✓)
-
-1.  **Unified URI Structure:** Implemented consistent URIs based on OpenAPI spec hierarchy (`openapi://{field}`, `openapi://paths/...`, `openapi://components/...`).
-2.  **OOP Rendering Layer:** Created `Renderable*` classes for modular rendering logic (`src/rendering/`).
-3.  **Refactored Handlers:** Replaced old handlers with new, focused handlers (`src/handlers/`).
-    - `TopLevelFieldHandler`
-    - `PathItemHandler`
-    - `OperationHandler`
-    - `ComponentMapHandler`
-    - `ComponentDetailHandler`
-4.  **Shared Utilities:** Extracted common logic into `src/rendering/utils.ts` and `src/handlers/handler-utils.ts`.
-5.  **Multi-Value Handling:** Correctly implemented handling for `*` variables (`method*`, `name*`).
-6.  **Testing:**
-    - Added/passed unit tests for all `Renderable*` classes.
-    - Added/passed E2E tests for the new URI structure using `complex-endpoint.json`.
-7.  **Documentation:** Updated `systemPatterns.md` and `progress.md`.
-8.  **Archived Old Code:** Moved previous implementations to `local-docs/old-implementation/`.
-9.  **URI Generation Refactor (✓):**
-    - Created centralized URI builder utility (`src/utils/uri-builder.ts`).
-    - Updated `$ref` transformation (`src/services/reference-transform.ts`) to use the builder and support all component types (`openapi://components/{type}/{name}`).
-    - Updated hint generation (`src/rendering/utils.ts`, `components.ts`, `path-item.ts`) to use the builder.
-    - Corrected path encoding in builder (removed leading slash encoding).
-    - Updated relevant unit tests (`uri-builder.test.ts`, `reference-transform.test.ts`, `path-item.test.ts`).
-    - Fixed `RenderablePathItem` instantiation in handlers (`path-item-handler.ts`, `operation-handler.ts`).
-10. **Security Fix (✓):** Resolved `security/detect-object-injection` warnings by implementing Map-based validation helpers (`getValidatedPathItem`, `getValidatedOperations`, `getValidatedComponentMap`, `getValidatedComponentDetails`) in `handler-utils.ts` and refactoring handlers (`operation-handler`, `path-item-handler`, `component-map-handler`, `component-detail-handler`) and rendering classes (`RenderablePaths`, `RenderableComponents`, `RenderableComponentMap`) to use safe access patterns inspired by the old implementation.
+Successfully upgraded @modelcontextprotocol/sdk from 1.10.1 to 1.11.0 and addressed breaking changes in test mocks.
 
 ## Implementation Status
 
-- Server now loads OpenAPI v3.0 and Swagger v2.0 specs from local files or remote URLs.
-- Swagger v2.0 specs are automatically converted to v3.0.
-- Internal references are transformed to MCP URIs.
-- Added `json-minified` output format option.
-- Server name is now dynamically set based on the loaded spec's `info.title`.
-- **New:** Automated versioning and release process implemented using `semantic-release`.
-- **New:** CI workflow adapted for Node 22, uses `just` for checks, and includes a `release` job using `cycjimmy/semantic-release-action@v4`.
-- **New:** Docker support added, including a production `Dockerfile`, integration with `semantic-release` via `@codedependant/semantic-release-docker`, and updated CI workflow for automated Docker Hub publishing.
-- Dependencies correctly categorized (`swagger2openapi` in `dependencies`, types in `devDependencies`).
-- Resource completion logic implemented.
-- Dynamic server name implemented.
-- Minified JSON output format added.
-- Remote spec loading and Swagger v2.0 conversion support added.
-- Core resource exploration functionality remains operational.
-- Unit tests for `SpecLoaderService` and `Formatters` are updated.
-- E2E tests cover basic loading scenarios, output formats, resource exploration, and resource completion.
-
-## Next Actions / Immediate Focus
-
-1.  **README Update (Partially Done):**
-    - **Done:** Added Docker usage instructions.
-    - **TODO:** Add details about the automated release process (npm + Docker) and Conventional Commits requirement.
-    - **TODO:** Add instructions for setting up `NPM_TOKEN`, `DOCKERHUB_USERNAME`, and `DOCKERHUB_TOKEN` secrets/variables.
-2.  **Handler Unit Tests:** Implement comprehensive unit tests for each handler class (`TopLevelFieldHandler`, `PathItemHandler`, etc.), mocking `SpecLoaderService` and `IFormatter`.
-3.  **Refactor Helpers:** Consolidate duplicated helper functions (`formatResults`, `isOpenAPIV3`) fully into `handler-utils.ts` and remove from individual handlers.
-4.  **Code Cleanup:** Address remaining TODOs (e.g., checking warnings in `spec-loader.ts`) and minor ESLint warnings.
-
-## Future Considerations (Post Immediate Actions)
-
-- Implement reference traversal/resolution service.
-- Enhance support for all component types.
+- @modelcontextprotocol/sdk updated from 1.10.1 to 1.11.0
+- Updated all test mocks to include new `RequestHandlerExtra` property (`requestId`).
+- Corrected import path for `RequestId` to `@modelcontextprotocol/sdk/types.js`.
+- Modified test files:
+  - component-map-handler.test.ts
+  - component-detail-handler.test.ts
+  - operation-handler.test.ts
+  - path-item-handler.test.ts
+  - top-level-field-handler.test.ts
+- All tests passing successfully
+- Server now loads OpenAPI v3.0 and Swagger v2.0 specs from local files or remote URLs
+- Swagger v2.0 specs are automatically converted to v3.0
+- Internal references are transformed to MCP URIs
+- Added `json-minified` output format option
+- Server name is now dynamically set based on the loaded spec's `info.title`
+- Automated versioning and release process implemented using `semantic-release`
+- CI workflow adapted for Node 22, uses `just` for checks, and includes a `release` job
+- Docker support added with automated Docker Hub publishing
+- Dependencies correctly categorized
+- Resource completion logic implemented
+- Dynamic server name implemented
+- Minified JSON output format added
+- Remote spec loading and Swagger v2.0 conversion support added
+- Core resource exploration functionality remains operational
+- Unit tests updated for latest SDK version
+- E2E tests cover all main functionality
+
+## Recent Changes
+
+### SDK Update to v1.11.0 & Test Fixes (✓)
+
+1. **Dependency Update:**
+
+   - Updated @modelcontextprotocol/sdk from 1.10.1 to 1.11.0 in `package.json`.
+   - Identified breaking change in `RequestHandlerExtra` type requiring a new `requestId` property.
+
+2. **Test Suite Updates:**
+   - Added the `requestId` property to `mockExtra` objects in all handler unit tests:
+     - `test/__tests__/unit/handlers/top-level-field-handler.test.ts`
+     - `test/__tests__/unit/handlers/component-map-handler.test.ts`
+     - `test/__tests__/unit/handlers/path-item-handler.test.ts`
+     - `test/__tests__/unit/handlers/operation-handler.test.ts`
+     - `test/__tests__/unit/handlers/component-detail-handler.test.ts`
+   - Corrected the import path for `RequestId` to `import { RequestId } from '@modelcontextprotocol/sdk/types.js';` in these files. This resolved previous TypeScript import errors and an ESLint warning regarding unsafe assignment also disappeared.
+   - Confirmed all test fixes by running `just build && just test` successfully.
+
+## Next Actions
+
+1. **Continue with Previous Plans:**
+
+   - Complete README updates with release process details
+   - Clean up any remaining TODOs in codebase
+   - Address minor ESLint warnings
+
+2. **Documentation:**
+
+   - Document the SDK upgrade in CHANGELOG.md
+   - Update dependencies section in relevant documentation
+
+3. **Testing:**
+
+   - Monitor for any new breaking changes in future SDK updates
+   - Consider adding test utilities to simplify mock creation
+
+4. **Code Cleanup:**
+   - Refactor duplicated mock setup code in tests
+   - Consider creating shared test fixtures for common mocks
+
+## Future Considerations
+
+1. **SDK Integration:**
+
+   - Stay updated with MCP SDK releases
+   - Plan for future breaking changes
+   - Consider automated dependency update checks
+
+2. **Testing Infrastructure:**
+
+   - Improve test mock reusability
+   - Add test coverage for edge cases
+   - Consider adding integration tests
+
+3. **Previous Future Considerations:**
+   - Implement reference traversal/resolution service
+   - Enhance support for all component types

package/memory-bank/progress.md

@@ -142,6 +142,7 @@
    - E2E tests updated for new structure and complex fixture. Added tests for resource completion.
    - Unit tests for `SpecLoaderService` updated for `swagger2openapi`.
    - CI workflow updated to use `just` and includes automated release job for npm and Docker.
+   - Handler unit tests updated to accommodate `@modelcontextprotocol/sdk` v1.11.0 changes (`RequestHandlerExtra` now requires `requestId`, and `RequestId` import path corrected to `@modelcontextprotocol/sdk/types.js`).
 
 3. API Design
    - New URI structure implemented, aligned with OpenAPI spec.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-openapi-schema-explorer",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "MCP OpenAPI schema explorer",
   "type": "module",
   "main": "dist/src/index.js",
@@ -36,11 +36,11 @@
   },
   "homepage": "https://github.com/kadykov/mcp-openapi-schema-explorer#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.8.0",
+    "@modelcontextprotocol/sdk": "^1.10.1",
     "js-yaml": "^4.1.0",
     "openapi-types": "^12.1.3",
     "swagger2openapi": "7.0.8",
-    "zod": "^3.24.2"
+    "zod": "^4.0.5"
   },
   "devDependencies": {
     "@codedependant/semantic-release-docker": "^5.1.0",
@@ -52,9 +52,9 @@
     "@semantic-release/github": "^11.0.1",
     "@semantic-release/npm": "^12.0.1",
     "@semantic-release/release-notes-generator": "^14.0.3",
-    "@types/jest": "^29.5.14",
+    "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.14.1",
+    "@types/node": "^24.0.3",
     "@types/node-fetch": "^2.6.12",
     "@types/swagger2openapi": "^7.0.4",
     "@typescript-eslint/eslint-plugin": "^8.29.0",
@@ -64,7 +64,7 @@
     "eslint-plugin-security": "^3.0.1",
     "globals": "^16.0.0",
     "husky": "^9.1.7",
-    "jest": "^29.7.0",
+    "jest": "^30.0.2",
     "jest-silent-reporter": "^0.6.0",
     "license-checker": "^25.0.1",
     "msw": "^2.7.4",

package/src/index.ts

@@ -50,11 +50,19 @@ async function main(): Promise<void> {
       ? `Schema Explorer for ${spec.info.title}`
       : defaultServerName;
 
+    // Brief help content for LLMs
+    const helpContent = `Use resorces/templates/list to get a list of available resources. Use openapi://paths to get a list of all endpoints.`;
+
     // Create MCP server with dynamic name
-    const server = new McpServer({
-      name: serverName,
-      version: VERSION, // Use the imported version
-    });
+    const server = new McpServer(
+      {
+        name: serverName,
+        version: VERSION, // Use the imported version
+      },
+      {
+        instructions: helpContent,
+      }
+    );
 
     // Set up formatter and new handlers
     const formatter = createFormatter(config.outputFormat);

package/src/version.ts

@@ -1,4 +1,4 @@
 // Auto-generated by scripts/generate-version.js during semantic-release prepare step
 // Do not edit this file manually.
 
-export const VERSION = '1.2.1';
+export const VERSION = '1.3.0';

package/test/__tests__/unit/handlers/component-detail-handler.test.ts

@@ -1,4 +1,5 @@
 import { OpenAPIV3 } from 'openapi-types';
+import { RequestId } from '@modelcontextprotocol/sdk/types.js';
 import { ComponentDetailHandler } from '../../../../src/handlers/component-detail-handler';
 import { SpecLoaderService } from '../../../../src/types';
 import { IFormatter, JsonFormatter } from '../../../../src/services/formatters';
@@ -62,7 +63,12 @@ describe('ComponentDetailHandler', () => {
   });
 
   describe('handleRequest', () => {
-    const mockExtra = { signal: new AbortController().signal };
+    const mockExtra = {
+      signal: new AbortController().signal,
+      sendNotification: jest.fn(),
+      sendRequest: jest.fn(),
+      requestId: 'test-request-id' as RequestId,
+    };
 
     it('should return detail for a single valid component (schema)', async () => {
       const variables: Variables = { type: 'schemas', name: 'User' }; // Use 'name' key

package/test/__tests__/unit/handlers/component-map-handler.test.ts

@@ -1,4 +1,5 @@
 import { OpenAPIV3 } from 'openapi-types';
+import { RequestId } from '@modelcontextprotocol/sdk/types.js';
 import { ComponentMapHandler } from '../../../../src/handlers/component-map-handler';
 import { SpecLoaderService } from '../../../../src/types';
 import { IFormatter, JsonFormatter } from '../../../../src/services/formatters';
@@ -48,7 +49,12 @@ describe('ComponentMapHandler', () => {
   });
 
   describe('handleRequest (List Component Names)', () => {
-    const mockExtra = { signal: new AbortController().signal };
+    const mockExtra = {
+      signal: new AbortController().signal,
+      sendNotification: jest.fn(),
+      sendRequest: jest.fn(),
+      requestId: 'test-request-id' as RequestId,
+    };
 
     it('should list names for a valid component type (schemas)', async () => {
       const variables: Variables = { type: 'schemas' };

package/test/__tests__/unit/handlers/operation-handler.test.ts

@@ -1,4 +1,5 @@
 import { OpenAPIV3 } from 'openapi-types';
+import { RequestId } from '@modelcontextprotocol/sdk/types.js';
 import { OperationHandler } from '../../../../src/handlers/operation-handler';
 import { SpecLoaderService } from '../../../../src/types';
 import { IFormatter, JsonFormatter } from '../../../../src/services/formatters';
@@ -58,7 +59,12 @@ describe('OperationHandler', () => {
   });
 
   describe('handleRequest', () => {
-    const mockExtra = { signal: new AbortController().signal };
+    const mockExtra = {
+      signal: new AbortController().signal,
+      sendNotification: jest.fn(),
+      sendRequest: jest.fn(),
+      requestId: 'test-request-id' as RequestId,
+    };
 
     it('should return detail for a single valid method', async () => {
       const variables: Variables = { path: encodedPathItems, method: 'get' }; // Use 'method' key

package/test/__tests__/unit/handlers/path-item-handler.test.ts

@@ -1,4 +1,5 @@
 import { OpenAPIV3 } from 'openapi-types';
+import { RequestId } from '@modelcontextprotocol/sdk/types.js';
 import { PathItemHandler } from '../../../../src/handlers/path-item-handler';
 import { SpecLoaderService } from '../../../../src/types';
 import { IFormatter, JsonFormatter } from '../../../../src/services/formatters';
@@ -50,7 +51,12 @@ describe('PathItemHandler', () => {
   });
 
   describe('handleRequest (List Methods)', () => {
-    const mockExtra = { signal: new AbortController().signal };
+    const mockExtra = {
+      signal: new AbortController().signal,
+      sendNotification: jest.fn(),
+      sendRequest: jest.fn(),
+      requestId: 'test-request-id' as RequestId,
+    };
 
     it('should list methods for a valid path', async () => {
       const variables: Variables = { path: encodedPathItems };

package/test/__tests__/unit/handlers/top-level-field-handler.test.ts

@@ -1,4 +1,5 @@
 import { OpenAPIV3 } from 'openapi-types';
+import { RequestId } from '@modelcontextprotocol/sdk/types.js';
 import { TopLevelFieldHandler } from '../../../../src/handlers/top-level-field-handler';
 import { SpecLoaderService } from '../../../../src/types';
 import { IFormatter, JsonFormatter } from '../../../../src/services/formatters';
@@ -40,14 +41,12 @@ describe('TopLevelFieldHandler', () => {
   });
 
   describe('handleRequest', () => {
-    // Create a mock extra object with the required signal property
     const mockExtra = {
       signal: new AbortController().signal,
+      sendNotification: jest.fn(),
+      sendRequest: jest.fn(),
+      requestId: 'test-request-id' as RequestId,
     };
-    // Cast to the expected type for the handler call signature if needed,
-    // but the object structure itself is simpler.
-    // Note: We might need to cast this later if strict type checks complain,
-    // but let's try the minimal structure first.
 
     it('should handle request for "info" field', async () => {
       mockGetTransformedSpec.mockResolvedValue(sampleSpec);