npm - mongodb-mcp-server - Versions diffs - 1.14.0-prerelease.3 → 1.15.0-alpha.1 - Mend

mongodb-mcp-server 1.14.0-prerelease.3 → 1.15.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (448) hide show

package/README.md CHANGED Viewed

@@ -336,7 +336,7 @@ For more information about configuring OpenCode as an MCP client, including the
 - `collection-indexes` - Describe the indexes for a collection
 - `collection-schema` - Describe the schema for a collection
 - `collection-storage-size` - Gets the size of the collection
-- `connect` - Connect to a MongoDB instance
+- `connect` - Connect to a MongoDB instance and get back a `connectionId` to pass to the other MongoDB tools. When the server is started with a configured connection string, a connection with the id `preconfigured` is available without calling this tool.
 - `count` - Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter
 - `create-collection` - Creates a new collection in a database. If the database doesn't exist, it will be created automatically.
 - `create-index` - Create an index for a collection
@@ -351,9 +351,10 @@ For more information about configuring OpenCode as an MCP client, including the
 - `insert-many` - Insert an array of documents into a MongoDB collection. If the list of documents is above com.mongodb/maxRequestPayloadBytes, consider inserting them in batches.
 - `list-collections` - List all collections for a given database
 - `list-databases` - List all databases for a MongoDB connection
+- `disconnect` - Close a MongoDB connection and revoke its `connectionId`
+- `list-connections` - List the active MongoDB connections and their `connectionId`s
 - `mongodb-logs` - Returns the most recent logged mongod events
 - `rename-collection` - Renames a collection in a MongoDB database
-- `switch-connection` - Switch to a different MongoDB connection
 - `update-many` - Updates all documents that match the specified filter for a collection. If the list of documents is above com.mongodb/maxRequestPayloadBytes, consider updating them in batches.
 #### MongoDB Atlas Tools
@@ -415,46 +416,49 @@ The MongoDB MCP Server can be configured using multiple methods, with the follow
 ### Configuration Options
-| Environment Variable / CLI Option                                                              | Default                                                                                                                                            | Description                                                                                                                                                                                              |
-| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `MDB_MCP_ALLOW_REQUEST_OVERRIDES` / `--allowRequestOverrides`                                  | `false`                                                                                                                                            | When set to true, allows configuration values to be overridden via request headers and query parameters.                                                                                                 |
-| `MDB_MCP_API_CLIENT_ID` / `--apiClientId`                                                      | `<not set>`                                                                                                                                        | Atlas API client ID for authentication. Required for running Atlas tools.                                                                                                                                |
-| `MDB_MCP_API_CLIENT_SECRET` / `--apiClientSecret`                                              | `<not set>`                                                                                                                                        | Atlas API client secret for authentication. Required for running Atlas tools.                                                                                                                            |
-| `MDB_MCP_ASSISTANT_BASE_URL` / `--assistantBaseUrl`                                            | `"https://knowledge.mongodb.com/api/v1/"`                                                                                                          | Base URL for the MongoDB Assistant API.                                                                                                                                                                  |
-| `MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` / `--atlasTemporaryDatabaseUserLifetimeMs` | `14400000`                                                                                                                                         | Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.                                              |
-| `MDB_MCP_CONFIRMATION_REQUIRED_TOOLS` / `--confirmationRequiredTools`                          | `"atlas-create-access-list,atlas-create-db-user,drop-database,drop-collection,delete-many,drop-index,atlas-streams-manage,atlas-streams-teardown"` | Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.                                                                        |
-| `MDB_MCP_CONNECTION_STRING` / `--connectionString`                                             | `<not set>`                                                                                                                                        | MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.                                              |
-| `MDB_MCP_DISABLE_SERVER_SIDE_JS` / `--disableServerSideJs`                                     | `true`                                                                                                                                             | When set to true, disallows the use of server-side JavaScript operators (such as $where, $function, and $accumulator) in query filters and aggregation pipelines.                                        |
-| `MDB_MCP_DISABLED_TOOLS` / `--disabledTools`                                                   | `""`                                                                                                                                               | Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.                                                                                                 |
-| `MDB_MCP_DRY_RUN` / `--dryRun`                                                                 | `false`                                                                                                                                            | When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.                                                                                   |
-| `MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS` / `--exportCleanupIntervalMs`                             | `120000`                                                                                                                                           | Time in milliseconds between export cleanup cycles that remove expired export files.                                                                                                                     |
-| `MDB_MCP_EXPORT_TIMEOUT_MS` / `--exportTimeoutMs`                                              | `300000`                                                                                                                                           | Time in milliseconds after which an export is considered expired and eligible for cleanup.                                                                                                               |
-| `MDB_MCP_EXPORTS_PATH` / `--exportsPath`                                                       | see below\*                                                                                                                                        | Folder to store exported data files.                                                                                                                                                                     |
-| `MDB_MCP_EXTERNALLY_MANAGED_SESSIONS` / `--externallyManagedSessions`                          | `false`                                                                                                                                            | When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.        |
-| `MDB_MCP_HEALTH_CHECK_HOST` / `--healthCheckHost`                                              | `<not set>`                                                                                                                                        | Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.               |
-| `MDB_MCP_HEALTH_CHECK_PORT` / `--healthCheckPort`                                              | `<not set>`                                                                                                                                        | Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.                       |
-| `MDB_MCP_HTTP_BODY_LIMIT` / `--httpBodyLimit`                                                  | `102400`                                                                                                                                           | Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.                           |
-| `MDB_MCP_HTTP_HEADERS` / `--httpHeaders`                                                       | `"{}"`                                                                                                                                             | Header that the HTTP server will validate when making requests (only used when transport is 'http').                                                                                                     |
-| `MDB_MCP_HTTP_HOST` / `--httpHost`                                                             | `"127.0.0.1"`                                                                                                                                      | Host address to bind the HTTP server to (only used when transport is 'http').                                                                                                                            |
-| `MDB_MCP_HTTP_PORT` / `--httpPort`                                                             | `3000`                                                                                                                                             | Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.                                                                                                           |
-| `MDB_MCP_HTTP_RESPONSE_TYPE` / `--httpResponseType`                                            | `"sse"`                                                                                                                                            | The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.                                                                                             |
-| `MDB_MCP_IDLE_TIMEOUT_MS` / `--idleTimeoutMs`                                                  | `600000`                                                                                                                                           | Idle timeout for a client to disconnect (only applies to http transport).                                                                                                                                |
-| `MDB_MCP_INDEX_CHECK` / `--indexCheck`                                                         | `false`                                                                                                                                            | When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.                                                                                    |
-| `MDB_MCP_LOG_PATH` / `--logPath`                                                               | see below\*                                                                                                                                        | Folder to store logs.                                                                                                                                                                                    |
-| `MDB_MCP_LOGGERS` / `--loggers`                                                                | `"disk,mcp"` see below\*                                                                                                                           | Comma separated values of logger types.                                                                                                                                                                  |
-| `MDB_MCP_MAX_BYTES_PER_QUERY` / `--maxBytesPerQuery`                                           | `16777216`                                                                                                                                         | The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.                                             |
-| `MDB_MCP_MAX_DOCUMENTS_PER_QUERY` / `--maxDocumentsPerQuery`                                   | `100`                                                                                                                                              | The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.          |
-| `MDB_MCP_MAX_TIME_M_S` / `--maxTimeMS`                                                         | `<not set>`                                                                                                                                        | The maximum time in milliseconds that operations are allowed to run on the MongoDB server. When set, this value is passed as the maxTimeMS option to read operations such as find, aggregate, and count. |
-| `MDB_MCP_MCP_CLIENT_LOG_LEVEL` / `--mcpClientLogLevel`                                         | `"debug"`                                                                                                                                          | Minimum severity level for log messages forwarded to the MCP client.                                                                                                                                     |
-| `MDB_MCP_MONITORING_SERVER_FEATURES` / `--monitoringServerFeatures`                            | `"health-check"`                                                                                                                                   | Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).                                                                  |
-| `MDB_MCP_MONITORING_SERVER_HOST` / `--monitoringServerHost`                                    | `<not set>`                                                                                                                                        | Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.                                                           |
-| `MDB_MCP_MONITORING_SERVER_PORT` / `--monitoringServerPort`                                    | `<not set>`                                                                                                                                        | Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.                                                                   |
-| `MDB_MCP_NOTIFICATION_TIMEOUT_MS` / `--notificationTimeoutMs`                                  | `540000`                                                                                                                                           | Notification timeout for a client to be aware of disconnect (only applies to http transport).                                                                                                            |
-| `MDB_MCP_PREVIEW_FEATURES` / `--previewFeatures`                                               | `""`                                                                                                                                               | Comma separated values of preview features that are enabled.                                                                                                                                             |
-| `MDB_MCP_READ_ONLY` / `--readOnly`                                                             | `false`                                                                                                                                            | When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.                                                                                    |
-| `MDB_MCP_TELEMETRY` / `--telemetry`                                                            | `"enabled"`                                                                                                                                        | When set to disabled, disables telemetry collection.                                                                                                                                                     |
-| `MDB_MCP_TRANSPORT` / `--transport`                                                            | `"stdio"`                                                                                                                                          | Either 'stdio' or 'http'.                                                                                                                                                                                |
-| `MDB_MCP_VOYAGE_API_KEY` / `--voyageApiKey`                                                    | `""`                                                                                                                                               | API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).                                                                     |
+| Environment Variable / CLI Option                                                              | Default                                                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                           |
+| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MDB_MCP_ALLOW_REQUEST_OVERRIDES` / `--allowRequestOverrides`                                  | `false`                                                                                                                                            | When set to true, allows configuration values to be overridden via request headers and query parameters.                                                                                                                                                                                                                                                                                                              |
+| `MDB_MCP_API_CLIENT_ID` / `--apiClientId`                                                      | `<not set>`                                                                                                                                        | Atlas API client ID for authentication. Required for running Atlas tools.                                                                                                                                                                                                                                                                                                                                             |
+| `MDB_MCP_API_CLIENT_SECRET` / `--apiClientSecret`                                              | `<not set>`                                                                                                                                        | Atlas API client secret for authentication. Required for running Atlas tools.                                                                                                                                                                                                                                                                                                                                         |
+| `MDB_MCP_ASSISTANT_BASE_URL` / `--assistantBaseUrl`                                            | `"https://knowledge.mongodb.com/api/v1/"`                                                                                                          | Base URL for the MongoDB Assistant API.                                                                                                                                                                                                                                                                                                                                                                               |
+| `MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` / `--atlasTemporaryDatabaseUserLifetimeMs` | `14400000`                                                                                                                                         | Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.                                                                                                                                                                                                                                                           |
+| `MDB_MCP_CONFIRMATION_REQUIRED_TOOLS` / `--confirmationRequiredTools`                          | `"atlas-create-access-list,atlas-create-db-user,drop-database,drop-collection,delete-many,drop-index,atlas-streams-manage,atlas-streams-teardown"` | Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.                                                                                                                                                                                                                                                                                     |
+| `MDB_MCP_CONNECTION_SCOPE` / `--connectionScope`                                               | `"session"`                                                                                                                                        | Visibility scope for MongoDB connections created at runtime. With 'session' (the default), each MCP session only sees the connections it created (plus the shared 'preconfigured' one) and they are closed when the session ends — recommended when the HTTP transport is exposed to multiple clients without authentication. With 'global', connections are shared across all sessions and survive session rotation. |
+| `MDB_MCP_CONNECTION_STRING` / `--connectionString`                                             | `<not set>`                                                                                                                                        | MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.                                                                                                                                                                                                                                                           |
+| `MDB_MCP_DISABLE_SERVER_SIDE_JS` / `--disableServerSideJs`                                     | `true`                                                                                                                                             | When set to true, disallows the use of server-side JavaScript operators (such as $where, $function, and $accumulator) in query filters and aggregation pipelines.                                                                                                                                                                                                                                                     |
+| `MDB_MCP_DISABLED_TOOLS` / `--disabledTools`                                                   | `""`                                                                                                                                               | Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.                                                                                                                                                                                                                                                                                                              |
+| `MDB_MCP_DRY_RUN` / `--dryRun`                                                                 | `false`                                                                                                                                            | When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.                                                                                                                                                                                                                                                                                                |
+| `MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS` / `--exportCleanupIntervalMs`                             | `120000`                                                                                                                                           | Time in milliseconds between export cleanup cycles that remove expired export files.                                                                                                                                                                                                                                                                                                                                  |
+| `MDB_MCP_EXPORT_TIMEOUT_MS` / `--exportTimeoutMs`                                              | `300000`                                                                                                                                           | Time in milliseconds after which an export is considered expired and eligible for cleanup.                                                                                                                                                                                                                                                                                                                            |
+| `MDB_MCP_EXPORTS_PATH` / `--exportsPath`                                                       | see below\*                                                                                                                                        | Folder to store exported data files.                                                                                                                                                                                                                                                                                                                                                                                  |
+| `MDB_MCP_EXTERNALLY_MANAGED_SESSIONS` / `--externallyManagedSessions`                          | `false`                                                                                                                                            | When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.                                                                                                                                                                                                                     |
+| `MDB_MCP_HEALTH_CHECK_HOST` / `--healthCheckHost`                                              | `<not set>`                                                                                                                                        | Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.                                                                                                                                                                                                                            |
+| `MDB_MCP_HEALTH_CHECK_PORT` / `--healthCheckPort`                                              | `<not set>`                                                                                                                                        | Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.                                                                                                                                                                                                                                    |
+| `MDB_MCP_HTTP_BODY_LIMIT` / `--httpBodyLimit`                                                  | `102400`                                                                                                                                           | Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.                                                                                                                                                                                                                                        |
+| `MDB_MCP_HTTP_HEADERS` / `--httpHeaders`                                                       | `"{}"`                                                                                                                                             | Header that the HTTP server will validate when making requests (only used when transport is 'http').                                                                                                                                                                                                                                                                                                                  |
+| `MDB_MCP_HTTP_HOST` / `--httpHost`                                                             | `"127.0.0.1"`                                                                                                                                      | Host address to bind the HTTP server to (only used when transport is 'http').                                                                                                                                                                                                                                                                                                                                         |
+| `MDB_MCP_HTTP_PORT` / `--httpPort`                                                             | `3000`                                                                                                                                             | Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.                                                                                                                                                                                                                                                                                                                        |
+| `MDB_MCP_HTTP_RESPONSE_TYPE` / `--httpResponseType`                                            | `"sse"`                                                                                                                                            | The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.                                                                                                                                                                                                                                                                                                          |
+| `MDB_MCP_IDLE_TIMEOUT_MS` / `--idleTimeoutMs`                                                  | `600000`                                                                                                                                           | Idle timeout for a client to disconnect (only applies to http transport).                                                                                                                                                                                                                                                                                                                                             |
+| `MDB_MCP_INDEX_CHECK` / `--indexCheck`                                                         | `false`                                                                                                                                            | When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.                                                                                                                                                                                                                                                                                                 |
+| `MDB_MCP_LOG_PATH` / `--logPath`                                                               | see below\*                                                                                                                                        | Folder to store logs.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `MDB_MCP_LOGGERS` / `--loggers`                                                                | `"disk,mcp"` see below\*                                                                                                                           | Comma separated values of logger types.                                                                                                                                                                                                                                                                                                                                                                               |
+| `MDB_MCP_MAX_ACTIVE_CONNECTIONS` / `--maxActiveConnections`                                    | `10`                                                                                                                                               | Maximum number of MongoDB connections a single scope (an MCP session by default, see `connectionScope`) can hold open. When the limit is exceeded, the scope's least-recently-used connection is closed and its connectionId revoked. The preconfigured connection does not count towards the limit.                                                                                                                  |
+| `MDB_MCP_MAX_BYTES_PER_QUERY` / `--maxBytesPerQuery`                                           | `16777216`                                                                                                                                         | The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.                                                                                                                                                                                                                                                          |
+| `MDB_MCP_MAX_DOCUMENTS_PER_QUERY` / `--maxDocumentsPerQuery`                                   | `100`                                                                                                                                              | The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.                                                                                                                                                                                                                       |
+| `MDB_MCP_MAX_SESSIONS` / `--maxSessions`                                                       | `1000`                                                                                                                                             | Maximum number of concurrent sessions the HTTP transport will hold in memory (only used when transport is 'http'). Each session holds a full server instance, transport, and timers, so choose a value based on your deployment's available memory; the default is a conservative safety net rather than a recommended production value.                                                                              |
+| `MDB_MCP_MAX_TIME_M_S` / `--maxTimeMS`                                                         | `<not set>`                                                                                                                                        | The maximum time in milliseconds that operations are allowed to run on the MongoDB server. When set, this value is passed as the maxTimeMS option to read operations such as find, aggregate, and count.                                                                                                                                                                                                              |
+| `MDB_MCP_MCP_CLIENT_LOG_LEVEL` / `--mcpClientLogLevel`                                         | `"debug"`                                                                                                                                          | Minimum severity level for log messages forwarded to the MCP client.                                                                                                                                                                                                                                                                                                                                                  |
+| `MDB_MCP_MONITORING_SERVER_FEATURES` / `--monitoringServerFeatures`                            | `"health-check"`                                                                                                                                   | Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).                                                                                                                                                                                                                                                                               |
+| `MDB_MCP_MONITORING_SERVER_HOST` / `--monitoringServerHost`                                    | `<not set>`                                                                                                                                        | Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.                                                                                                                                                                                                                                                                        |
+| `MDB_MCP_MONITORING_SERVER_PORT` / `--monitoringServerPort`                                    | `<not set>`                                                                                                                                        | Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.                                                                                                                                                                                                                                                                                |
+| `MDB_MCP_NOTIFICATION_TIMEOUT_MS` / `--notificationTimeoutMs`                                  | `540000`                                                                                                                                           | Notification timeout for a client to be aware of disconnect (only applies to http transport).                                                                                                                                                                                                                                                                                                                         |
+| `MDB_MCP_PREVIEW_FEATURES` / `--previewFeatures`                                               | `""`                                                                                                                                               | Comma separated values of preview features that are enabled.                                                                                                                                                                                                                                                                                                                                                          |
+| `MDB_MCP_READ_ONLY` / `--readOnly`                                                             | `false`                                                                                                                                            | When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.                                                                                                                                                                                                                                                                                                 |
+| `MDB_MCP_TELEMETRY` / `--telemetry`                                                            | `"enabled"`                                                                                                                                        | When set to disabled, disables telemetry collection.                                                                                                                                                                                                                                                                                                                                                                  |
+| `MDB_MCP_TRANSPORT` / `--transport`                                                            | `"stdio"`                                                                                                                                          | Either 'stdio' or 'http'.                                                                                                                                                                                                                                                                                                                                                                                             |
+| `MDB_MCP_VOYAGE_API_KEY` / `--voyageApiKey`                                                    | `""`                                                                                                                                               | API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).                                                                                                                                                                                                                                                                                  |
 #### Logger Options

package/dist/cjs/common/config/userConfig.d.ts CHANGED Viewed

@@ -42,6 +42,12 @@ export declare const UserConfigSchema: z.ZodObject<{
     httpBodyLimit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     idleTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     notificationTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    maxSessions: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    maxActiveConnections: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    connectionScope: z.ZodDefault<z.ZodEnum<{
+        session: "session";
+        global: "global";
+    }>>;
     maxBytesPerQuery: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     maxDocumentsPerQuery: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     maxTimeMS: z.ZodOptional<z.ZodCoercedNumber<unknown>>;

package/dist/cjs/common/config/userConfig.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"userConfig.d.ts","sourceRoot":"","sources":["../../../../src/common/config/userConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,KAAK,eAAe,EASvB,MAAM,kBAAkB,CAAC;AAM1B,eAAO,MAAM,cAAc,qHAAgC,CAAC;~~AAuS5D~~,eAAO,MAAM,gBAAgB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe,EAA0C,CAAC,MAAM,UAAU,CAAC,EAAE,CAAC"}
1	+ {"version":3,"file":"userConfig.d.ts","sourceRoot":"","sources":["../../../../src/common/config/userConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,KAAK,eAAe,EASvB,MAAM,kBAAkB,CAAC;AAM1B,eAAO,MAAM,cAAc,qHAAgC,CAAC;AAgU5D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe,EAA0C,CAAC,MAAM,UAAU,CAAC,EAAE,CAAC"}

package/dist/cjs/common/config/userConfig.js CHANGED Viewed

@@ -140,6 +140,25 @@ const ServerConfigSchema = zod_1.z.object({
         .default(540000)
         .describe("Notification timeout for a client to be aware of disconnect (only applies to http transport).")
         .register(exports.configRegistry, { overrideBehavior: (0, configUtils_js_1.onlyLowerThanBaseValueOverride)() }),
+    maxSessions: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1, "Invalid maxSessions: must be at least 1")
+        .default(constants_js_1.DEFAULT_MAX_SESSIONS)
+        .describe("Maximum number of concurrent sessions the HTTP transport will hold in memory (only used when transport is 'http'). Each session holds a full server instance, transport, and timers, so choose a value based on your deployment's available memory; the default is a conservative safety net rather than a recommended production value.")
+        .register(exports.configRegistry, { overrideBehavior: "not-allowed" }),
+    maxActiveConnections: zod_1.z.coerce
+        .number()
+        .int()
+        .min(1, "Invalid maxActiveConnections: must be at least 1")
+        .default(10)
+        .describe("Maximum number of MongoDB connections a single scope (an MCP session by default, see connectionScope) can hold open. When exceeded, the scope's least-recently-used connection is closed and its connectionId revoked. The preconfigured connection does not count towards the limit.")
+        .register(exports.configRegistry, { overrideBehavior: "not-allowed" }),
+    connectionScope: zod_1.z
+        .enum(["session", "global"])
+        .default("session")
+        .describe("Visibility scope for MongoDB connections created at runtime. With 'session' (the default), each MCP session only sees the connections it created (plus the shared 'preconfigured' one) and they are closed when the session ends — recommended when the HTTP transport is exposed to multiple clients without authentication. With 'global', connections are shared across all sessions and survive session rotation.")
+        .register(exports.configRegistry, { overrideBehavior: "not-allowed" }),
     maxBytesPerQuery: zod_1.z.coerce
         .number()
         .default(16777216)

package/dist/cjs/common/config/userConfig.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"userConfig.js","sourceRoot":"","sources":["../../../../src/common/config/userConfig.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qDAU0B;AAC1B,gEAA4D;AAC5D,8CAAoF;AACpF,+DAA0G;AAC1G,~~gEAAyE~~;~~AAE5D~~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"}
1	+ {"version":3,"file":"userConfig.js","sourceRoot":"","sources":["../../../../src/common/config/userConfig.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qDAU0B;AAC1B,gEAA4D;AAC5D,8CAAoF;AACpF,+DAA0G;AAC1G,gEAA+F;AAElF,QAAA,cAAc,GAAG,OAAC,CAAC,QAAQ,EAAmB,CAAC;AAE5D,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,OAAC;SACR,MAAM,EAAE;SACR,OAAO,CAAC,4BAA4B,CAAC;SACrC,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,gBAAgB,EAAE,OAAC;SACd,MAAM,EAAE;SACR,OAAO,CAAC,uCAAuC,CAAC;SAChD,QAAQ,CAAC,yCAAyC,CAAC;SACnD,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;SACrF,QAAQ,CAAC,sBAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClF,eAAe,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;SACzF,QAAQ,CAAC,sBAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClF,gBAAgB,EAAE,OAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,6JAA6J,CAChK;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClF,OAAO,EAAE,OAAC;SACL,UAAU,CACP,CAAC,GAAkC,EAAE,EAAE,CAAC,IAAA,sCAAqB,EAAC,GAAG,CAAC,EAClE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAC7C;SACA,KAAK,CACF,OAAC,CAAC,SAAS,CAAC,CAAC,EAAE,0BAA0B,CAAC,EAC1C,OAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,EAAE;QAChD,OAAO,EAAE,mCAAmC;KAC/C,CAAC,CACL;SACA,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;SACxB,QAAQ,CAAC,2BAA2B,CAAC;SACrC,QAAQ,CAAC,sBAAc,EAAE;QACtB,uBAAuB,EAAE,yBAAyB;QAClD,gBAAgB,EAAE,aAAa;KAClC,CAAC;IACN,OAAO,EAAE,OAAC;SACL,MAAM,EAAE;SACR,OAAO,CAAC,IAAA,2BAAU,GAAE,CAAC;SACrB,QAAQ,CAAC,uBAAuB,CAAC;SACjC,QAAQ,CAAC,sBAAc,EAAE,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IACzG,iBAAiB,EAAE,OAAC;SACf,IAAI,CAAC,gCAAc,CAAC;SACpB,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,sEAAsE,CAAC;SAChF,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,IAAA,6CAA4B,EAAC,gCAAc,CAAC,EAAE,CAAC;IACjG,aAAa,EAAE,OAAC;SACX,UAAU,CAAC,CAAC,GAAkC,EAAE,EAAE,CAAC,IAAA,sCAAqB,EAAC,GAAG,CAAC,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACnG,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,4FAA4F,CAAC;SACtG,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5D,yBAAyB,EAAE,OAAC;SACvB,UAAU,CAAC,CAAC,GAAkC,EAAE,EAAE,CAAC,IAAA,sCAAqB,EAAC,GAAG,CAAC,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACnG,OAAO,CAAC;QACL,0BAA0B;QAC1B,sBAAsB;QACtB,eAAe;QACf,iBAAiB;QACjB,aAAa;QACb,YAAY;QACZ,sBAAsB;QACtB,wBAAwB;KAC3B,CAAC;SACD,QAAQ,CACL,qHAAqH,CACxH;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5D,QAAQ,EAAE,OAAC;SACN,UAAU,CAAC,6BAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SACrC,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACL,uHAAuH,CAC1H;SACA,QAAQ,CAAC,sBAAc,EAAE;QACtB,gBAAgB,EAAE,IAAA,+BAAc,EAAC,IAAI,CAAC;KACzC,CAAC;IACN,UAAU,EAAE,OAAC;SACR,UAAU,CAAC,6BAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SACrC,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACL,uHAAuH,CAC1H;SACA,QAAQ,CAAC,sBAAc,EAAE;QACtB,gBAAgB,EAAE,IAAA,+BAAc,EAAC,IAAI,CAAC;KACzC,CAAC;IACN,mBAAmB,EAAE,OAAC;SACjB,UAAU,CAAC,6BAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SACrC,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACL,mKAAmK,CACtK;SACA,QAAQ,CAAC,sBAAc,EAAE;QACtB,gBAAgB,EAAE,IAAA,+BAAc,EAAC,IAAI,CAAC;KACzC,CAAC;IACN,SAAS,EAAE,OAAC;SACP,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;SAC7B,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,sDAAsD,CAAC;SAChE,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,SAAS,EAAE,OAAC;SACP,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;SACvB,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,2BAA2B,CAAC;SACrC,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,QAAQ,EAAE,OAAC,CAAC,MAAM;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,GAAG,CAAC,KAAK,EAAE,yCAAyC,CAAC;SACrD,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gGAAgG,CAAC;SAC1G,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,QAAQ,EAAE,OAAC;SACN,MAAM,EAAE;SACR,OAAO,CAAC,WAAW,CAAC;SACpB,QAAQ,CAAC,+EAA+E,CAAC;SACzF,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,CAAC;SACV,KAAK,EAAE;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACL,sGAAsG,CACzG;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,aAAa,EAAE,OAAC,CAAC,MAAM;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CACA,uCAAwB,CAAC,IAAI,EAC7B,2CAA2C,uCAAwB,CAAC,IAAI,QAAQ,CACnF;SACA,OAAO,CAAC,uCAAwB,CAAC,IAAI,CAAC;SACtC,QAAQ,CACL,gLAAgL,CACnL;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,aAAa,EAAE,OAAC,CAAC,MAAM;SAClB,MAAM,EAAE;SACR,OAAO,CAAC,MAAO,CAAC;SAChB,QAAQ,CAAC,2EAA2E,CAAC;SACrF,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,IAAA,+CAA8B,GAAE,EAAE,CAAC;IACrF,qBAAqB,EAAE,OAAC,CAAC,MAAM;SAC1B,MAAM,EAAE;SACR,OAAO,CAAC,MAAO,CAAC;SAChB,QAAQ,CAAC,+FAA+F,CAAC;SACzG,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,IAAA,+CAA8B,GAAE,EAAE,CAAC;IACrF,WAAW,EAAE,OAAC,CAAC,MAAM;SAChB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,yCAAyC,CAAC;SACjD,OAAO,CAAC,mCAAoB,CAAC;SAC7B,QAAQ,CACL,0UAA0U,CAC7U;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,oBAAoB,EAAE,OAAC,CAAC,MAAM;SACzB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACL,uRAAuR,CAC1R;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,eAAe,EAAE,OAAC;SACb,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;SAC3B,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CACL,uZAAuZ,CAC1Z;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,gBAAgB,EAAE,OAAC,CAAC,MAAM;SACrB,MAAM,EAAE;SACR,OAAO,CAAC,QAAU,CAAC;SACnB,QAAQ,CACL,8JAA8J,CACjK;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,oBAAoB,EAAE,OAAC,CAAC,MAAM;SACzB,MAAM,EAAE;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CACL,iMAAiM,CACpM;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,SAAS,EAAE,OAAC,CAAC,MAAM;SACd,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CACL,0MAA0M,CAC7M;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,OAAO,CAAC,IAAA,+BAAc,GAAE,CAAC;SACzB,QAAQ,CAAC,sCAAsC,CAAC;SAChD,QAAQ,CAAC,sBAAc,EAAE,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IACzG,eAAe,EAAE,OAAC,CAAC,MAAM;SACpB,MAAM,EAAE;SACR,OAAO,CAAC,MAAO,CAAC;SAChB,QAAQ,CAAC,4FAA4F,CAAC;SACtG,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,IAAA,+CAA8B,GAAE,EAAE,CAAC;IACrF,uBAAuB,EAAE,OAAC,CAAC,MAAM;SAC5B,MAAM,EAAE;SACR,OAAO,CAAC,MAAO,CAAC;SAChB,QAAQ,CAAC,sFAAsF,CAAC;SAChG,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,oCAAoC,EAAE,OAAC,CAAC,MAAM;SACzC,MAAM,EAAE;SACR,OAAO,CAAC,QAAU,CAAC;SACnB,QAAQ,CACL,6JAA6J,CAChK;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,IAAA,+CAA8B,GAAE,EAAE,CAAC;IACrF,YAAY,EAAE,OAAC;SACV,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACL,sIAAsI,CACzI;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClF,eAAe,EAAE,OAAC;SACb,UAAU,CACP,CAAC,GAAkC,EAAE,EAAE,CAAC,IAAA,sCAAqB,EAAC,GAAG,CAAC,EAClE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,iCAAoB,CAAC,CAAC,CACxC;SACA,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,gDAAgD,CAAC;SAC1D,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,IAAA,8CAA6B,GAAE,EAAE,CAAC;IACpF,qBAAqB,EAAE,OAAC;SACnB,UAAU,CAAC,6BAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SACrC,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACL,0GAA0G,CAC7G;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,MAAM,EAAE,OAAC;SACJ,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACL,wHAAwH,CAC3H;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,yBAAyB,EAAE,OAAC;SACvB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACL,mMAAmM,CACtM;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,gBAAgB,EAAE,OAAC;SACd,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;SACrB,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACL,8GAA8G,CACjH;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,sDAAsD;IACtD,eAAe,EAAE,OAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;SACrD,GAAG,CAAC,KAAK,EAAE,gDAAgD,CAAC;SAC5D,QAAQ,EAAE;SACV,QAAQ,CACL,oLAAoL,CACvL;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;SAC7D,QAAQ,CAAC,wBAAW,EAAE,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,CAAC;IAC9E,sDAAsD;IACtD,eAAe,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,4LAA4L,CAC/L;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;SAC7D,QAAQ,CAAC,wBAAW,EAAE,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,CAAC;IAC9E,oBAAoB,EAAE,OAAC;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,GAAG,CAAC,KAAK,EAAE,qDAAqD,CAAC;SACjE,QAAQ,EAAE;SACV,QAAQ,CACL,wIAAwI,CAC3I;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,oBAAoB,EAAE,OAAC;SAClB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,gJAAgJ,CACnJ;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClE,wBAAwB,EAAE,OAAC;SACtB,UAAU,CACP,CAAC,GAAkC,EAAE,EAAE,CAAC,IAAA,sCAAqB,EAAC,GAAG,CAAC,EAClE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,0CAA6B,CAAC,CAAC,CACjD;SACA,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;SACzB,QAAQ,CACL,yIAAyI,CAC5I;SACA,QAAQ,CAAC,sBAAc,EAAE,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACrE,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,GAAG,6BAAuB,CAAC,KAAK;IAChC,GAAG,kBAAkB,CAAC,KAAK;CAC9B,CAAC,CAAC;AAIU,QAAA,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,wBAAgB,CAAC,KAAK,CAAyB,CAAC"}

package/dist/cjs/common/connectionErrorHandler.d.ts CHANGED Viewed

@@ -2,10 +2,10 @@ import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import { ErrorCodes, type MongoDBError } from "./errors.js";
 import type { AnyConnectionState } from "./connectionManager.js";
 import type { AnyToolBase } from "../tools/tool.js";
-export type ConnectionErrorHandler = (error: MongoDBError<ErrorCodes.NotConnectedToMongoDB | ErrorCodes.MisconfiguredConnectionString>, additionalContext: ConnectionErrorHandlerContext) => ConnectionErrorUnhandled | ConnectionErrorHandled | Promise<ConnectionErrorUnhandled | ConnectionErrorHandled>;
+export type ConnectionErrorHandler = (error: MongoDBError<ErrorCodes.NotConnectedToMongoDB | ErrorCodes.MisconfiguredConnectionString | ErrorCodes.UnknownConnectionId>, additionalContext: ConnectionErrorHandlerContext) => ConnectionErrorUnhandled | ConnectionErrorHandled | Promise<ConnectionErrorUnhandled | ConnectionErrorHandled>;
 export type ConnectionErrorHandlerContext = {
     availableTools: AnyToolBase[];
-    connectionState: AnyConnectionState;
+    connectionState?: AnyConnectionState;
 };
 export type ConnectionErrorUnhandled = {
     errorHandled: false;
@@ -14,5 +14,11 @@ export type ConnectionErrorHandled = {
     errorHandled: true;
     result: CallToolResult;
 };
+/**
+ * The enabled tools that can establish a connection. The disconnect tool
+ * shares the "connect" operation type but cannot establish one, so it is
+ * excluded.
+ */
+export declare function connectCapableTools(tools: AnyToolBase[]): AnyToolBase[];
 export declare const connectionErrorHandler: ConnectionErrorHandler;
 //# sourceMappingURL=connectionErrorHandler.d.ts.map

package/dist/cjs/common/connectionErrorHandler.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"connectionErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/common/connectionErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;~~AAEpD~~,MAAM,MAAM,sBAAsB,GAAG,CACjC,KAAK,EAAE,YAAY,~~CAAC~~,UAAU,CAAC,qBAAqB,GAAG,UAAU,CAAC,6BAA6B,CAAC,~~EAChG~~,iBAAiB,EAAE,6BAA6B,KAC/C,wBAAwB,GAAG,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,GAAG,sBAAsB,CAAC,CAAC;AAEpH,MAAM,MAAM,6BAA6B,GAAG;IAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAAC,eAAe,EAAE,kBAAkB,CAAA;CAAE,CAAC;~~AACnH~~,MAAM,MAAM,wBAAwB,GAAG;IAAE,YAAY,EAAE,KAAK,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,sBAAsB,GAAG;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAEpF,eAAO,MAAM,sBAAsB,EAAE,~~sBAoFpC~~,CAAC"}
1	+ {"version":3,"file":"connectionErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/common/connectionErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,MAAM,sBAAsB,GAAG,CACjC,KAAK,EAAE,YAAY,CACf,UAAU,CAAC,qBAAqB,GAAG,UAAU,CAAC,6BAA6B,GAAG,UAAU,CAAC,mBAAmB,CAC/G,EACD,iBAAiB,EAAE,6BAA6B,KAC/C,wBAAwB,GAAG,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,GAAG,sBAAsB,CAAC,CAAC;AAEpH,MAAM,MAAM,6BAA6B,GAAG;IAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAAC,eAAe,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AACpH,MAAM,MAAM,wBAAwB,GAAG;IAAE,YAAY,EAAE,KAAK,CAAA;CAAE,CAAC;AAC/D,MAAM,MAAM,sBAAsB,GAAG;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAEvE;AAED,eAAO,MAAM,sBAAsB,EAAE,sBAgGpC,CAAC"}

package/dist/cjs/common/connectionErrorHandler.js CHANGED Viewed

@@ -1,11 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.connectionErrorHandler = void 0;
+exports.connectCapableTools = connectCapableTools;
 const errors_js_1 = require("./errors.js");
+const disconnect_js_1 = require("../tools/mongodb/connect/disconnect.js");
+/**
+ * The enabled tools that can establish a connection. The disconnect tool
+ * shares the "connect" operation type but cannot establish one, so it is
+ * excluded.
+ */
+function connectCapableTools(tools) {
+    return tools.filter((t) => t.operationType === "connect" && t.name !== disconnect_js_1.DisconnectTool.toolName && t.isEnabled());
+}
 const connectionErrorHandler = (error, { availableTools, connectionState }) => {
-    const connectTools = availableTools
-        .filter((t) => t.operationType === "connect" && t.isEnabled())
-        .sort((a, b) => a.category.localeCompare(b.category)); // Sort Atlas tools before MongoDB tools
+    const connectTools = connectCapableTools(availableTools).sort((a, b) => a.category.localeCompare(b.category)); // Sort Atlas tools before MongoDB tools
     // Find what Atlas connect tools are available and suggest when the LLM should to use each. If no Atlas tools are found, return a suggestion for the MongoDB connect tool.
     const atlasConnectTool = connectTools?.find((t) => t.category === "atlas");
     const atlasLocalConnectTool = connectTools?.find((t) => t.category === "atlas-local");
@@ -23,7 +31,7 @@ const connectionErrorHandler = (error, { availableTools, connectionState }) => {
     })();
     const connectToolsNames = connectTools?.map((t) => `"${t.name}"`).join(", ");
     const additionalPromptForConnectivity = [];
-    if (connectionState.tag === "connecting" && connectionState.oidcConnectionType) {
+    if (connectionState?.tag === "connecting" && connectionState.oidcConnectionType) {
         additionalPromptForConnectivity.push({
             type: "text",
             text: `The user needs to finish their OIDC connection by opening '${connectionState.oidcLoginUrl}' in the browser and use the following user code: '${connectionState.oidcUserCode}'`,
@@ -38,6 +46,20 @@ const connectionErrorHandler = (error, { availableTools, connectionState }) => {
         });
     }
     switch (error.code) {
+        case errors_js_1.ErrorCodes.UnknownConnectionId:
+            return {
+                errorHandled: true,
+                result: {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${error.message} Call the "list-connections" tool to see the active connections, or establish a new one and retry with the connectionId it returns.`,
+                        },
+                        ...additionalPromptForConnectivity,
+                    ],
+                    isError: true,
+                },
+            };
         case errors_js_1.ErrorCodes.NotConnectedToMongoDB:
             return {
                 errorHandled: true,

package/dist/cjs/common/connectionErrorHandler.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"connectionErrorHandler.js","sourceRoot":"","sources":["../../../src/common/connectionErrorHandler.ts"],"names":[],"mappings":";;;~~AACA~~,2CAA4D;~~AAarD~~,~~MAAM~~,~~sBAAsB~~,~~GAA2B~~,CAAC,KAAK,~~EAAE~~,~~EAAE~~,~~cAAc~~,~~EAAE~~,~~eAAe~~,EAAE,EAAE,~~EAAE;IACzG~~,~~MAAM~~,~~YAAY~~,~~GAAG~~,~~cAAc;SAC9B~~,~~MAAM~~,CAAC,CAAC,CAAC,~~EAAE~~,EAAE,CAAC,CAAC,CAAC,~~aAAa~~,KAAK,~~SAAS~~,~~IAAI~~,~~CAAC~~,~~CAAC~~,~~SAAS~~,EAAE,~~CAAC~~;~~SAC7D~~,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,wCAAwC;~~IAEnG~~,0KAA0K;IAC1K,MAAM,gBAAgB,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC3E,MAAM,qBAAqB,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC;IAEtF,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE;QACjC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,gBAAgB,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CACN,kCAAkC,gBAAgB,CAAC,IAAI,6cAA6c,CACvgB,CAAC;QACN,CAAC;QAED,IAAI,qBAAqB,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CACN,mQAAmQ,qBAAqB,CAAC,IAAI,uUAAuU,CACvmB,CAAC;QACN,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAClB,CAAC,CAAC,gOAAgO,CAAC;IAC3O,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,iBAAiB,GAAG,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,+BAA+B,GAAqC,EAAE,CAAC;IAE7E,IAAI,eAAe,~~CAAC~~,GAAG,KAAK,YAAY,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC;~~QAC7E~~,+BAA+B,CAAC,IAAI,CAAC;YACjC,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,8DAA8D,eAAe,CAAC,YAAY,sDAAsD,eAAe,CAAC,YAAY,GAAG;SACxL,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACJ,+BAA+B,CAAC,IAAI,CAAC;YACjC,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,iBAAiB;gBACnB,CAAC,CAAC,0CAA0C,iBAAiB,4GAA4G,cAAc,EAAE;gBACzL,CAAC,CAAC,iIAAiI;SAC1I,CAAC,CAAC;IACP,CAAC;IAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,sBAAU,CAAC,qBAAqB;YACjC,OAAO;gBACH,YAAY,EAAE,IAAI;gBAClB,MAAM,EAAE;oBACJ,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,2EAA2E;yBACpF;wBACD,GAAG,+BAA+B;qBACrC;oBACD,OAAO,EAAE,IAAI;iBAChB;aACJ,CAAC;QACN,KAAK,sBAAU,CAAC,6BAA6B;YACzC,OAAO;gBACH,YAAY,EAAE,IAAI;gBAClB,MAAM,EAAE;oBACJ,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,sIAAsI;yBAC/I;wBACD;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,YAAY;gCACd,CAAC,CAAC,0DAA0D,iBAAiB,sCAAsC,cAAc,EAAE;gCACnI,CAAC,CAAC,0FAA0F;yBACnG;qBACJ;oBACD,OAAO,EAAE,IAAI;iBAChB;aACJ,CAAC;QAEN;YACI,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;AACL,CAAC,CAAC;~~AApFW~~,QAAA,sBAAsB,~~0BAoFjC~~"}
1	+ {"version":3,"file":"connectionErrorHandler.js","sourceRoot":"","sources":["../../../src/common/connectionErrorHandler.ts"],"names":[],"mappings":"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"}

package/dist/cjs/common/connectionRegistry.d.ts ADDED Viewed

@@ -0,0 +1,196 @@
+import type { NodeDriverServiceProvider } from "@mongosh/service-provider-node-driver";
+import type { DeviceId } from "../helpers/deviceId.js";
+import type { LoggerBase } from "./logging/index.js";
+import type { UserConfig } from "./config/userConfig.js";
+import type { AnyConnectionState, ConnectionManager, ConnectionSettings } from "./connectionManager.js";
+/**
+ * The reserved, well-known id of the connection seeded from the `connectionString`
+ * config option. Deliberately has no random suffix: it is meant to be citable in
+ * docs and tool descriptions, there is exactly one per server, and guessing it on
+ * a server without a configured connection string fails with an instructive error.
+ */
+export declare const PRECONFIGURED_CONNECTION_ID = "preconfigured";
+export type ConnectionSource = "explicit" | "preconfigured";
+export type CreateConnectionEntryOptions = {
+    /**
+     * Label for the connection — e.g. a host or cluster name. Stored on the
+     * entry slugified and disambiguated with a short random suffix, and
+     * surfaced in connection listings. Labels are not identifiers: connections
+     * are only ever addressed by their opaque connectionId.
+     */
+    name: string;
+    /**
+     * Name of the MCP client the connection is established for; embedded in
+     * the driver `appName` so connections are attributable in server logs.
+     */
+    clientName?: string;
+    /**
+     * Cleanup invoked when the connection is revoked (explicit disconnect,
+     * connection-limit overflow, or store shutdown) — e.g. deleting
+     * credentials provisioned for the connection. Runs at most once; failures
+     * are logged, never thrown.
+     */
+    onRevoke?: () => Promise<void>;
+};
+export type CreateConnectionOptions = {
+    /** The connection string and driver options to dial with. */
+    settings: ConnectionSettings;
+    /**
+     * Optional label for the connection. Stored on the entry slugified and
+     * disambiguated with a short random suffix, and surfaced in connection
+     * listings. Generated from the Atlas cluster name or the connection
+     * string's host when omitted. Labels are not identifiers: connections are
+     * only ever addressed by their opaque connectionId.
+     */
+    name?: string;
+    /**
+     * Name of the MCP client the connection is established for; embedded in
+     * the driver `appName` so connections are attributable in server logs.
+     */
+    clientName?: string;
+};
+/**
+ * A named collection of MongoDB connections addressed by opaque connection
+ * ids ("handles"). Consumers establish connections via
+ * {@link ConnectionRegistry.connect} (or {@link ConnectionRegistry.createEntry}
+ * when they drive the dialing themselves) and refer to them everywhere else by
+ * the returned entry's id.
+ *
+ * A registry is always fully bound to the connections it can see: instances
+ * are obtained from {@link MCPConnectionStore.view} (which fixes the
+ * visibility scope at creation time) or supplied by an embedder. Consequently
+ * no method takes any notion of caller identity, scope, or context.
+ *
+ * Every method is asynchronous: implementations may hold entries in memory
+ * (like the default store) or back them with external storage, doing I/O on
+ * each lookup.
+ */
+export interface ConnectionRegistry {
+    /** Creates an entry without dialing it, for callers that drive the dial themselves (e.g. retrying connect flows). */
+    createEntry(opts: CreateConnectionEntryOptions): Promise<ConnectionEntry>;
+    /** Creates an entry and dials it. A failed dial leaves no entry behind. */
+    connect(opts: CreateConnectionOptions): Promise<ConnectionEntry>;
+    /** Looks up an entry and marks it as used. */
+    get(connectionId: string): Promise<ConnectionEntry | undefined>;
+    /** Looks up an entry without affecting LRU ordering (telemetry, error handling). */
+    peek(connectionId: string): Promise<ConnectionEntry | undefined>;
+    /** Entries matching a predicate, without affecting LRU ordering. */
+    find(predicate: (entry: ConnectionEntry) => boolean): Promise<ConnectionEntry[]>;
+    /** Resolves a handle to a live service provider; throws `UnknownConnectionId` for absent handles. */
+    resolve(connectionId: string): Promise<NodeDriverServiceProvider>;
+    /**
+     * Closes the identified connection. Explicit entries are revoked — the
+     * connectionId stops resolving; the preconfigured entry is closed but
+     * remains available and re-dials on next use. Throws `UnknownConnectionId`
+     * for absent handles, like {@link ConnectionRegistry.resolve}.
+     */
+    disconnect(connectionId: string): Promise<void>;
+    /** Disconnects every entry reachable through this registry object. */
+    closeAll(): Promise<void>;
+}
+type ConnectionEntryOptions = {
+    connectionId: string;
+    name: string;
+    source: ConnectionSource;
+    manager: ConnectionManager;
+    onRevoke?: () => Promise<void>;
+};
+/**
+ * A named connection held by a {@link ConnectionRegistry}. Each entry owns its
+ * own {@link ConnectionManager} (dialing, state machine, OIDC handling), so the
+ * registry is a collection of independent connection lifecycles keyed by handle.
+ */
+export declare class ConnectionEntry {
+    /**
+     * The opaque handle the connection is addressed by — a UUID with no
+     * derivable structure. The one exception is the preconfigured entry, whose
+     * id is the well-known literal "preconfigured".
+     */
+    readonly connectionId: string;
+    /**
+     * Human/model-readable label: the supplied or generated name, slugified
+     * and suffixed for disambiguation (e.g. `my-project-cluster0-4f2a`).
+     */
+    readonly name: string;
+    readonly source: ConnectionSource;
+    readonly createdAt: Date;
+    lastUsedAt: Date;
+    lastError?: string;
+    /** Revocation cleanup armed at creation; see {@link CreateConnectionEntryOptions.onRevoke}. */
+    private onRevoke?;
+    private readonly manager;
+    constructor({ connectionId, name, source, manager, onRevoke }: ConnectionEntryOptions);
+    get state(): AnyConnectionState;
+    /**
+     * Invokes the revocation cleanup supplied at creation and disarms it, so
+     * the cleanup runs at most once even when triggered both directly and by
+     * a later revocation.
+     */
+    runRevokeCleanup(): Promise<void>;
+    connect(settings: ConnectionSettings): Promise<AnyConnectionState>;
+    /**
+     * Returns the live service provider or throws a `NotConnectedToMongoDB` error
+     * describing why the entry is not usable (Atlas dial still in progress, OIDC
+     * flow pending, or plain not connected).
+     */
+    getServiceProvider(): NodeDriverServiceProvider;
+    isSearchSupported(logger: LoggerBase): Promise<boolean>;
+    assertSearchSupported(logger: LoggerBase): Promise<void>;
+    close(): Promise<void>;
+}
+export type CreateConnectionManagerFn = () => ConnectionManager;
+export type ConnectionStoreOptions = {
+    userConfig: UserConfig;
+    logger: LoggerBase;
+    deviceId: DeviceId;
+    /** Override the per-entry connection manager (tests, embedders). */
+    createConnectionManager?: CreateConnectionManagerFn;
+};
+/**
+ * Owns the app-level storage and lifecycle of MongoDB connection handles: the
+ * entry map, the preconfigured entry seeded from a configured connection
+ * string, per-scope connection limits, and shutdown. Consumers never hold the
+ * store directly — they access entries through {@link ConnectionRegistry}
+ * views minted with {@link MCPConnectionStore.view}.
+ */
+export declare class MCPConnectionStore {
+    private readonly entries;
+    private readonly userConfig;
+    private readonly logger;
+    private readonly createConnectionManager;
+    private preconfiguredDial?;
+    constructor(options: ConnectionStoreOptions);
+    /**
+     * Returns a {@link ConnectionRegistry} over this store. When `scope` is
+     * provided, entries created through the returned registry are tagged with
+     * it and the registry only surfaces entries of that scope plus shared ones
+     * (`entry.scope === undefined`, e.g. the preconfigured entry) — invisible
+     * handles behave exactly like absent ones. When `scope` is omitted, the
+     * registry sees every entry and creates shared ones.
+     *
+     * `closeAll()` on the returned registry disconnects only the entries it
+     * can reach; the preconfigured entry is closed-but-kept per its usual
+     * disconnect semantics.
+     */
+    view(scope?: string): ConnectionRegistry;
+    /** Closes and removes every entry, including the preconfigured one. For process/runner shutdown. */
+    closeAll(): Promise<void>;
+    private addEntry;
+    private dialPreconfigured;
+    /**
+     * Enforces `maxActiveConnections` per scope, counting explicit entries only
+     * (the preconfigured entry is pinned). Per-scope counting means one scope
+     * (e.g. session) cannot evict another's handles.
+     */
+    private enforceLimit;
+    private revoke;
+}
+/**
+ * Slug source for Atlas cluster handles: `<projectName>-<clusterName>`.
+ * Cluster names are only unique within a project, so the project name
+ * disambiguates; when the combination exceeds the slug budget, the project
+ * half is truncated first so the cluster name always survives.
+ */
+export declare function atlasClusterSlug(projectName: string | undefined, clusterName: string): string;
+export {};
+//# sourceMappingURL=connectionRegistry.d.ts.map