Merge remote-tracking branch 'origin' into chore/mcp-235

Author: kmruiz

.github/dependabot.yml

@@ -4,6 +4,22 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    ignore:
+      # We are ignoring major updates on yargs-parser because yargs-parser@22
+      # does not play nicely when bundled using webpack. Our VSCode extension
+      # bundles MCP server with the extension code and yargs-parser from MCP
+      # server ends up on the final bundle which leads to issues such as -
+      # https://github.com/mongodb-js/vscode/issues/1149.
+      #
+      # This was reported to yargs-parser as well -
+      # https://github.com/yargs/yargs-parser/issues/517 and we already tried
+      # their suggestion about disabling the meta resolution in webpack,
+      # alongside others (dependency overrides, disabling the bundling of
+      # yargs-parser), and none of the solutions yield a working extension. So
+      # until we figure out a fix for this we need to keep mongodb-mcp-server
+      # working with v21 of yargs-parser.
+      - dependency-name: "yargs-parser"
+        update-types: ["version-update:semver-major"]
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:

.github/workflows/jira-issue.yml

@@ -54,7 +54,7 @@ jobs:
 
       - name: Add comment
         if: steps.create.outputs.issue-key
-        uses: peter-evans/create-or-update-comment@71345be0265236311c031f5c7866368bd1eff043
+        uses: peter-evans/create-or-update-comment@e8674b075228eee787fea43ef493e45ece1004c9
         with:
           issue-number: ${{ github.event.issue.number }}
           body: |
@@ -104,7 +104,7 @@ jobs:
           transition-id: 61
       - name: Add closure comment
         if: steps.close_jira_ticket.outcome == 'success'
-        uses: peter-evans/create-or-update-comment@71345be0265236311c031f5c7866368bd1eff043
+        uses: peter-evans/create-or-update-comment@e8674b075228eee787fea43ef493e45ece1004c9
         with:
           issue-number: ${{ github.event.issue.number }}
           body: |

README.md

@@ -360,6 +360,7 @@ The MongoDB MCP Server can be configured using multiple methods, with the follow
 | `exportTimeoutMs`                      | `MDB_MCP_EXPORT_TIMEOUT_MS`                         | 300000                                                                      | Time in milliseconds after which an export is considered expired and eligible for cleanup.                                                                                                              |
 | `exportCleanupIntervalMs`              | `MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS`                | 120000                                                                      | Time in milliseconds between export cleanup cycles that remove expired export files.                                                                                                                    |
 | `atlasTemporaryDatabaseUserLifetimeMs` | `MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` | 14400000                                                                    | Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.                                             |
+| `voyageApiKey`                         | `MDB_VOYAGE_API_KEY`                                | <not set>                                                                   | API key for communicating with Voyage AI. Used for generating embeddings for Vector search.                                                                                                             |
 
 #### Logger Options
 

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "mongodb-mcp-server",
   "description": "MongoDB Model Context Protocol Server",
-  "version": "1.0.2",
+  "version": "1.0.3-prerelease.1",
   "type": "module",
   "exports": {
     ".": {
@@ -116,7 +116,7 @@
     "oauth4webapi": "^3.8.0",
     "openapi-fetch": "^0.14.0",
     "ts-levenshtein": "^1.0.7",
-    "yargs-parser": "^22.0.0",
+    "yargs-parser": "21.1.1",
     "zod": "^3.25.76"
   },
   "engines": {

package.json

@@ -53,6 +53,7 @@ const OPTIONS = {
         "exportsPath",
         "exportTimeoutMs",
         "exportCleanupIntervalMs",
+        "voyageApiKey",
     ],
     boolean: [
         "apiDeprecationErrors",
@@ -181,6 +182,7 @@ export interface UserConfig extends CliOptions {
     maxDocumentsPerQuery: number;
     maxBytesPerQuery: number;
     atlasTemporaryDatabaseUserLifetimeMs: number;
+    voyageApiKey: string;
 }
 
 export const defaultUserConfig: UserConfig = {
@@ -210,6 +212,7 @@ export const defaultUserConfig: UserConfig = {
     maxDocumentsPerQuery: 100, // By default, we only fetch a maximum 100 documents per query / aggregation
     maxBytesPerQuery: 16 * 1024 * 1024, // By default, we only return ~16 mb of data per query / aggregation
     atlasTemporaryDatabaseUserLifetimeMs: 4 * 60 * 60 * 1000, // 4 hours
+    voyageApiKey: "",
 };
 
 export const config = setupUserConfig({

src/common/config.ts

@@ -1,5 +1,5 @@
 // This file was generated by scripts/updatePackageVersion.ts - Do not edit it manually.
 export const packageInfo = {
-    version: "1.0.2",
+    version: "1.0.3-prerelease.1",
     mcpServerName: "MongoDB MCP Server",
 };

src/common/packageInfo.ts

@@ -18,7 +18,7 @@ import {
     UnsubscribeRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 import assert from "assert";
-import type { ToolBase } from "./tools/tool.js";
+import type { ToolBase, ToolConstructorParams } from "./tools/tool.js";
 import { validateConnectionString } from "./helpers/connectionOptions.js";
 import { packageInfo } from "./common/packageInfo.js";
 import { type ConnectionErrorHandler } from "./common/connectionErrorHandler.js";
@@ -31,6 +31,7 @@ export interface ServerOptions {
     telemetry: Telemetry;
     elicitation: Elicitation;
     connectionErrorHandler: ConnectionErrorHandler;
+    toolConstructors?: (new (params: ToolConstructorParams) => ToolBase)[];
 }
 
 export class Server {
@@ -39,6 +40,7 @@ export class Server {
     private readonly telemetry: Telemetry;
     public readonly userConfig: UserConfig;
     public readonly elicitation: Elicitation;
+    private readonly toolConstructors: (new (params: ToolConstructorParams) => ToolBase)[];
     public readonly tools: ToolBase[] = [];
     public readonly connectionErrorHandler: ConnectionErrorHandler;
 
@@ -51,14 +53,23 @@ export class Server {
     private readonly startTime: number;
     private readonly subscriptions = new Set<string>();
 
-    constructor({ session, mcpServer, userConfig, telemetry, connectionErrorHandler, elicitation }: ServerOptions) {
+    constructor({
+        session,
+        mcpServer,
+        userConfig,
+        telemetry,
+        connectionErrorHandler,
+        elicitation,
+        toolConstructors,
+    }: ServerOptions) {
         this.startTime = Date.now();
         this.session = session;
         this.telemetry = telemetry;
         this.mcpServer = mcpServer;
         this.userConfig = userConfig;
         this.elicitation = elicitation;
         this.connectionErrorHandler = connectionErrorHandler;
+        this.toolConstructors = toolConstructors ?? [...AtlasTools, ...MongoDbTools];
     }
 
     async connect(transport: Transport): Promise<void> {
@@ -206,7 +217,7 @@ export class Server {
     }
 
     private registerTools(): void {
-        for (const toolConstructor of [...AtlasTools, ...MongoDbTools]) {
+        for (const toolConstructor of this.toolConstructors) {
             const tool = new toolConstructor({
                 session: this.session,
                 config: this.userConfig,

src/server.ts

@@ -42,6 +42,7 @@ export class CollectionStorageSizeTool extends MongoDBToolBase {
                         type: "text",
                     },
                 ],
+                isError: true,
             };
         }
 

src/tools/mongodb/metadata/collectionStorageSize.ts

@@ -37,6 +37,7 @@ export class CollectionIndexesTool extends MongoDBToolBase {
                         type: "text",
                     },
                 ],
+                isError: true,
             };
         }