mongodb-mcp-server

MongoDB Model Context Protocol Server

stdioofficialapplication

Package Details

mongodb-mcp-server

1.4.0-prerelease.1•https://www.npmjs.com/package/mongodb-mcp-server

Transportstdio

Package Arguments

Named

--allowRequestOverrides

When set to true, allows configuration values to be overridden via request headers and query parameters.

--apiClientId

Atlas API client ID for authentication. Required for running Atlas tools.

--apiClientSecret

Atlas API client secret for authentication. Required for running Atlas tools.

--atlasTemporaryDatabaseUserLifetimeMs

Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.

--confirmationRequiredTools

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

--connectionString

MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.

--disabledTools

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

--dryRun

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

--embeddingsValidation

When set to false, disables validation of embeddings dimensions.

--exportCleanupIntervalMs

Time in milliseconds between export cleanup cycles that remove expired export files.

--exportTimeoutMs

Time in milliseconds after which an export is considered expired and eligible for cleanup.

--exportsPath

Folder to store exported data files.

--httpBodyLimit

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.

--httpHeaders

Header that the HTTP server will validate when making requests (only used when transport is 'http').

--httpHost

Host address to bind the HTTP server to (only used when transport is 'http').

--httpPort

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

--idleTimeoutMs

Idle timeout for a client to disconnect (only applies to http transport).

--indexCheck

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

--logPath

Folder to store logs.

--loggers

Comma separated values of logger types.

--maxBytesPerQuery

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.

--maxDocumentsPerQuery

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.

--notificationTimeoutMs

Notification timeout for a client to be aware of disconnect (only applies to http transport).

--previewFeatures

Comma separated values of preview features that are enabled.

--readOnly

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

--telemetry

When set to disabled, disables telemetry collection.

--transport

Either 'stdio' or 'http'.

--vectorSearchDimensions

Default number of dimensions for vector search embeddings.

--vectorSearchSimilarityFunction

Default similarity function for vector search: 'euclidean', 'cosine', or 'dotProduct'.

--voyageApiKey

API key for Voyage AI embeddings service (required for vector search operations with text-to-embedding conversion).

Environment Variables

MDB_MCP_ALLOW_REQUEST_OVERRIDES(bool)

When set to true, allows configuration values to be overridden via request headers and query parameters.

MDB_MCP_API_CLIENT_ID(str)

Secret

Atlas API client ID for authentication. Required for running Atlas tools.

MDB_MCP_API_CLIENT_SECRET(str)

Secret

Atlas API client secret for authentication. Required for running Atlas tools.

MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS(num)

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(str)

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

MDB_MCP_CONNECTION_STRING(str)

Secret

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_DISABLED_TOOLS(str)

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

MDB_MCP_DRY_RUN(bool)

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

MDB_MCP_EMBEDDINGS_VALIDATION(bool)

When set to false, disables validation of embeddings dimensions.

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS(num)

Time in milliseconds between export cleanup cycles that remove expired export files.

MDB_MCP_EXPORT_TIMEOUT_MS(num)

Time in milliseconds after which an export is considered expired and eligible for cleanup.

MDB_MCP_EXPORTS_PATH(str)

Folder to store exported data files.

MDB_MCP_HTTP_BODY_LIMIT(num)

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(str)

Header that the HTTP server will validate when making requests (only used when transport is 'http').

MDB_MCP_HTTP_HOST(str)

Host address to bind the HTTP server to (only used when transport is 'http').

MDB_MCP_HTTP_PORT(num)

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

MDB_MCP_IDLE_TIMEOUT_MS(num)

Idle timeout for a client to disconnect (only applies to http transport).

MDB_MCP_INDEX_CHECK(bool)

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

MDB_MCP_LOG_PATH(str)

Folder to store logs.

MDB_MCP_LOGGERS(str)

Comma separated values of logger types.

MDB_MCP_MAX_BYTES_PER_QUERY(num)

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(num)

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_NOTIFICATION_TIMEOUT_MS(num)

Notification timeout for a client to be aware of disconnect (only applies to http transport).

MDB_MCP_PREVIEW_FEATURES(str)

Comma separated values of preview features that are enabled.

MDB_MCP_READ_ONLY(bool)

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

MDB_MCP_TELEMETRY(str)

When set to disabled, disables telemetry collection.

MDB_MCP_TRANSPORT(str)

Either 'stdio' or 'http'.

MDB_MCP_VECTOR_SEARCH_DIMENSIONS(num)

Default number of dimensions for vector search embeddings.

MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION(str)

Default similarity function for vector search: 'euclidean', 'cosine', or 'dotProduct'.

MDB_MCP_VOYAGE_API_KEY(str)

Secret

API key for Voyage AI embeddings service (required for vector search operations with text-to-embedding conversion).

docker.io/mongodb/mongodb-mcp-server:1.4.0-prerelease.1

https://hub.docker.com/r/mongodb/mongodb-mcp-server

Transportstdio

Package Arguments

Named

--allowRequestOverrides

When set to true, allows configuration values to be overridden via request headers and query parameters.

--apiClientId

Atlas API client ID for authentication. Required for running Atlas tools.

--apiClientSecret

Atlas API client secret for authentication. Required for running Atlas tools.

--atlasTemporaryDatabaseUserLifetimeMs

Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.

--confirmationRequiredTools

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

--connectionString

MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.

--disabledTools

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

--dryRun

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

--embeddingsValidation

When set to false, disables validation of embeddings dimensions.

--exportCleanupIntervalMs

Time in milliseconds between export cleanup cycles that remove expired export files.

--exportTimeoutMs

Time in milliseconds after which an export is considered expired and eligible for cleanup.

--exportsPath

Folder to store exported data files.

--httpBodyLimit

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.

--httpHeaders

Header that the HTTP server will validate when making requests (only used when transport is 'http').

--httpHost

Host address to bind the HTTP server to (only used when transport is 'http').

--httpPort

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

--idleTimeoutMs

Idle timeout for a client to disconnect (only applies to http transport).

--indexCheck

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

--logPath

Folder to store logs.

--loggers

Comma separated values of logger types.

--maxBytesPerQuery

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.

--maxDocumentsPerQuery

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.

--notificationTimeoutMs

Notification timeout for a client to be aware of disconnect (only applies to http transport).

--previewFeatures

Comma separated values of preview features that are enabled.

--readOnly

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

--telemetry

When set to disabled, disables telemetry collection.

--transport

Either 'stdio' or 'http'.

--vectorSearchDimensions

Default number of dimensions for vector search embeddings.

--vectorSearchSimilarityFunction

Default similarity function for vector search: 'euclidean', 'cosine', or 'dotProduct'.

--voyageApiKey

API key for Voyage AI embeddings service (required for vector search operations with text-to-embedding conversion).

Environment Variables

MDB_MCP_ALLOW_REQUEST_OVERRIDES(bool)

When set to true, allows configuration values to be overridden via request headers and query parameters.

MDB_MCP_API_CLIENT_ID(str)

Secret

Atlas API client ID for authentication. Required for running Atlas tools.

MDB_MCP_API_CLIENT_SECRET(str)

Secret

Atlas API client secret for authentication. Required for running Atlas tools.

MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS(num)

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(str)

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

MDB_MCP_CONNECTION_STRING(str)

Secret

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_DISABLED_TOOLS(str)

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

MDB_MCP_DRY_RUN(bool)

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

MDB_MCP_EMBEDDINGS_VALIDATION(bool)

When set to false, disables validation of embeddings dimensions.

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS(num)

Time in milliseconds between export cleanup cycles that remove expired export files.

MDB_MCP_EXPORT_TIMEOUT_MS(num)

Time in milliseconds after which an export is considered expired and eligible for cleanup.

MDB_MCP_EXPORTS_PATH(str)

Folder to store exported data files.

MDB_MCP_HTTP_BODY_LIMIT(num)

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(str)

Header that the HTTP server will validate when making requests (only used when transport is 'http').

MDB_MCP_HTTP_HOST(str)

Host address to bind the HTTP server to (only used when transport is 'http').

MDB_MCP_HTTP_PORT(num)

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

MDB_MCP_IDLE_TIMEOUT_MS(num)

Idle timeout for a client to disconnect (only applies to http transport).

MDB_MCP_INDEX_CHECK(bool)

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

MDB_MCP_LOG_PATH(str)

Folder to store logs.

MDB_MCP_LOGGERS(str)

Comma separated values of logger types.

MDB_MCP_MAX_BYTES_PER_QUERY(num)

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(num)

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_NOTIFICATION_TIMEOUT_MS(num)

Notification timeout for a client to be aware of disconnect (only applies to http transport).

MDB_MCP_PREVIEW_FEATURES(str)

Comma separated values of preview features that are enabled.

MDB_MCP_READ_ONLY(bool)

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

MDB_MCP_TELEMETRY(str)

When set to disabled, disables telemetry collection.

MDB_MCP_TRANSPORT(str)

Either 'stdio' or 'http'.

MDB_MCP_VECTOR_SEARCH_DIMENSIONS(num)

Default number of dimensions for vector search embeddings.

MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION(str)

Default similarity function for vector search: 'euclidean', 'cosine', or 'dotProduct'.

MDB_MCP_VOYAGE_API_KEY(str)

Secret

API key for Voyage AI embeddings service (required for vector search operations with text-to-embedding conversion).