MongoDB MCP Server
概览
作者提供的说明(英文原文)
MongoDB Model Context Protocol Server
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i3 项中通过 3 项依据公开信息检查;尚未扫描代码
- 使用情况i广泛使用↓ 15.8万/周 · ★ 1,160
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在你的电脑上运行
- 传输方式: stdio
- 分类: 数据库与数据集
- 你需要填写:MDB_MCP_API_CLIENT_ID, MDB_MCP_API_CLIENT_SECRET, MDB_MCP_CONNECTION_STRING, MDB_MCP_CONNECTION_STRINGS, MDB_MCP_VOYAGE_API_KEY
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:3 项中通过 3 项
- 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
- 需要你自己填写:
MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP,MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS,MDB_MCP_ALLOW_REQUEST_OVERRIDES,MDB_MCP_API_CLIENT_ID,MDB_MCP_API_CLIENT_SECRET,MDB_MCP_ASSISTANT_BASE_URL,MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS,MDB_MCP_CONFIRMATION_REQUIRED_TOOLS,MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS,MDB_MCP_CONNECTION_SCOPE,MDB_MCP_CONNECTION_STRING,MDB_MCP_CONNECTION_STRINGS,MDB_MCP_DANGEROUS_HOST_BINDING,MDB_MCP_DISABLE_SERVER_SIDE_JS,MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING,MDB_MCP_DISABLED_TOOLS,MDB_MCP_DRY_RUN,MDB_MCP_ELICITATION_TIMEOUT_MS,MDB_MCP_EVICTION_IDLE_GRACE_M_S,MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS,MDB_MCP_EXPORT_TIMEOUT_MS,MDB_MCP_EXPORTS_PATH,MDB_MCP_EXTERNALLY_MANAGED_SESSIONS,MDB_MCP_HEALTH_CHECK_HOST,MDB_MCP_HEALTH_CHECK_PORT,MDB_MCP_HTTP_BODY_LIMIT,MDB_MCP_HTTP_HEADERS,MDB_MCP_HTTP_HOST,MDB_MCP_HTTP_PORT,MDB_MCP_HTTP_RESPONSE_TYPE,MDB_MCP_IDLE_TIMEOUT_MS,MDB_MCP_INDEX_CHECK,MDB_MCP_LOG_PATH,MDB_MCP_LOGGERS,MDB_MCP_MAX_ACTIVE_CONNECTIONS,MDB_MCP_MAX_BYTES_PER_QUERY,MDB_MCP_MAX_DOCUMENTS_PER_QUERY,MDB_MCP_MAX_SESSIONS,MDB_MCP_MAX_TIME_M_S,MDB_MCP_MCP_CLIENT_LOG_LEVEL,MDB_MCP_MONITORING_SERVER_FEATURES,MDB_MCP_MONITORING_SERVER_HOST,MDB_MCP_MONITORING_SERVER_PORT,MDB_MCP_NOTIFICATION_TIMEOUT_MS,MDB_MCP_PREVIEW_FEATURES,MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP,MDB_MCP_QUERY_COUNT_TIMEOUT_MS,MDB_MCP_READ_ONLY,MDB_MCP_TELEMETRY,MDB_MCP_TIMEOUT_MS,MDB_MCP_TRANSPORT,MDB_MCP_VOYAGE_API_KEY
标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json
{
"mcpServers": {
"mongodb": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server"
],
"env": {
"MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP": "your-value",
"MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS": "your-value",
"MDB_MCP_ALLOW_REQUEST_OVERRIDES": "your-value",
"MDB_MCP_API_CLIENT_ID": "your-value",
"MDB_MCP_API_CLIENT_SECRET": "your-value",
"MDB_MCP_ASSISTANT_BASE_URL": "your-value",
"MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "your-value",
"MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
"MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS": "your-value",
"MDB_MCP_CONNECTION_SCOPE": "your-value",
"MDB_MCP_CONNECTION_STRING": "your-value",
"MDB_MCP_CONNECTION_STRINGS": "your-value",
"MDB_MCP_DANGEROUS_HOST_BINDING": "your-value",
"MDB_MCP_DISABLE_SERVER_SIDE_JS": "your-value",
"MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING": "your-value",
"MDB_MCP_DISABLED_TOOLS": "your-value",
"MDB_MCP_DRY_RUN": "your-value",
"MDB_MCP_ELICITATION_TIMEOUT_MS": "your-value",
"MDB_MCP_EVICTION_IDLE_GRACE_M_S": "your-value",
"MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "your-value",
"MDB_MCP_EXPORT_TIMEOUT_MS": "your-value",
"MDB_MCP_EXPORTS_PATH": "your-value",
"MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "your-value",
"MDB_MCP_HEALTH_CHECK_HOST": "your-value",
"MDB_MCP_HEALTH_CHECK_PORT": "your-value",
"MDB_MCP_HTTP_BODY_LIMIT": "your-value",
"MDB_MCP_HTTP_HEADERS": "your-value",
"MDB_MCP_HTTP_HOST": "your-value",
"MDB_MCP_HTTP_PORT": "your-value",
"MDB_MCP_HTTP_RESPONSE_TYPE": "your-value",
"MDB_MCP_IDLE_TIMEOUT_MS": "your-value",
"MDB_MCP_INDEX_CHECK": "your-value",
"MDB_MCP_LOG_PATH": "your-value",
"MDB_MCP_LOGGERS": "your-value",
"MDB_MCP_MAX_ACTIVE_CONNECTIONS": "your-value",
"MDB_MCP_MAX_BYTES_PER_QUERY": "your-value",
"MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "your-value",
"MDB_MCP_MAX_SESSIONS": "your-value",
"MDB_MCP_MAX_TIME_M_S": "your-value",
"MDB_MCP_MCP_CLIENT_LOG_LEVEL": "your-value",
"MDB_MCP_MONITORING_SERVER_FEATURES": "your-value",
"MDB_MCP_MONITORING_SERVER_HOST": "your-value",
"MDB_MCP_MONITORING_SERVER_PORT": "your-value",
"MDB_MCP_NOTIFICATION_TIMEOUT_MS": "your-value",
"MDB_MCP_PREVIEW_FEATURES": "your-value",
"MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP": "your-value",
"MDB_MCP_QUERY_COUNT_TIMEOUT_MS": "your-value",
"MDB_MCP_READ_ONLY": "your-value",
"MDB_MCP_TELEMETRY": "your-value",
"MDB_MCP_TIMEOUT_MS": "your-value",
"MDB_MCP_TRANSPORT": "your-value",
"MDB_MCP_VOYAGE_API_KEY": "your-value"
}
}
}
}在终端中运行这条命令
claude mcp add mongodb --env MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP=your-value --env MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS=your-value --env MDB_MCP_ALLOW_REQUEST_OVERRIDES=your-value --env MDB_MCP_API_CLIENT_ID=your-value --env MDB_MCP_API_CLIENT_SECRET=your-value --env MDB_MCP_ASSISTANT_BASE_URL=your-value --env MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS=your-value --env MDB_MCP_CONFIRMATION_REQUIRED_TOOLS=your-value --env MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS=your-value --env MDB_MCP_CONNECTION_SCOPE=your-value --env MDB_MCP_CONNECTION_STRING=your-value --env MDB_MCP_CONNECTION_STRINGS=your-value --env MDB_MCP_DANGEROUS_HOST_BINDING=your-value --env MDB_MCP_DISABLE_SERVER_SIDE_JS=your-value --env MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING=your-value --env MDB_MCP_DISABLED_TOOLS=your-value --env MDB_MCP_DRY_RUN=your-value --env MDB_MCP_ELICITATION_TIMEOUT_MS=your-value --env MDB_MCP_EVICTION_IDLE_GRACE_M_S=your-value --env MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS=your-value --env MDB_MCP_EXPORT_TIMEOUT_MS=your-value --env MDB_MCP_EXPORTS_PATH=your-value --env MDB_MCP_EXTERNALLY_MANAGED_SESSIONS=your-value --env MDB_MCP_HEALTH_CHECK_HOST=your-value --env MDB_MCP_HEALTH_CHECK_PORT=your-value --env MDB_MCP_HTTP_BODY_LIMIT=your-value --env MDB_MCP_HTTP_HEADERS=your-value --env MDB_MCP_HTTP_HOST=your-value --env MDB_MCP_HTTP_PORT=your-value --env MDB_MCP_HTTP_RESPONSE_TYPE=your-value --env MDB_MCP_IDLE_TIMEOUT_MS=your-value --env MDB_MCP_INDEX_CHECK=your-value --env MDB_MCP_LOG_PATH=your-value --env MDB_MCP_LOGGERS=your-value --env MDB_MCP_MAX_ACTIVE_CONNECTIONS=your-value --env MDB_MCP_MAX_BYTES_PER_QUERY=your-value --env MDB_MCP_MAX_DOCUMENTS_PER_QUERY=your-value --env MDB_MCP_MAX_SESSIONS=your-value --env MDB_MCP_MAX_TIME_M_S=your-value --env MDB_MCP_MCP_CLIENT_LOG_LEVEL=your-value --env MDB_MCP_MONITORING_SERVER_FEATURES=your-value --env MDB_MCP_MONITORING_SERVER_HOST=your-value --env MDB_MCP_MONITORING_SERVER_PORT=your-value --env MDB_MCP_NOTIFICATION_TIMEOUT_MS=your-value --env MDB_MCP_PREVIEW_FEATURES=your-value --env MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP=your-value --env MDB_MCP_QUERY_COUNT_TIMEOUT_MS=your-value --env MDB_MCP_READ_ONLY=your-value --env MDB_MCP_TELEMETRY=your-value --env MDB_MCP_TIMEOUT_MS=your-value --env MDB_MCP_TRANSPORT=your-value --env MDB_MCP_VOYAGE_API_KEY=your-value -- npx -y mongodb-mcp-server运行前请先填写空着的值。
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"mongodb": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server"
],
"env": {
"MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP": "your-value",
"MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS": "your-value",
"MDB_MCP_ALLOW_REQUEST_OVERRIDES": "your-value",
"MDB_MCP_API_CLIENT_ID": "your-value",
"MDB_MCP_API_CLIENT_SECRET": "your-value",
"MDB_MCP_ASSISTANT_BASE_URL": "your-value",
"MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "your-value",
"MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
"MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS": "your-value",
"MDB_MCP_CONNECTION_SCOPE": "your-value",
"MDB_MCP_CONNECTION_STRING": "your-value",
"MDB_MCP_CONNECTION_STRINGS": "your-value",
"MDB_MCP_DANGEROUS_HOST_BINDING": "your-value",
"MDB_MCP_DISABLE_SERVER_SIDE_JS": "your-value",
"MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING": "your-value",
"MDB_MCP_DISABLED_TOOLS": "your-value",
"MDB_MCP_DRY_RUN": "your-value",
"MDB_MCP_ELICITATION_TIMEOUT_MS": "your-value",
"MDB_MCP_EVICTION_IDLE_GRACE_M_S": "your-value",
"MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "your-value",
"MDB_MCP_EXPORT_TIMEOUT_MS": "your-value",
"MDB_MCP_EXPORTS_PATH": "your-value",
"MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "your-value",
"MDB_MCP_HEALTH_CHECK_HOST": "your-value",
"MDB_MCP_HEALTH_CHECK_PORT": "your-value",
"MDB_MCP_HTTP_BODY_LIMIT": "your-value",
"MDB_MCP_HTTP_HEADERS": "your-value",
"MDB_MCP_HTTP_HOST": "your-value",
"MDB_MCP_HTTP_PORT": "your-value",
"MDB_MCP_HTTP_RESPONSE_TYPE": "your-value",
"MDB_MCP_IDLE_TIMEOUT_MS": "your-value",
"MDB_MCP_INDEX_CHECK": "your-value",
"MDB_MCP_LOG_PATH": "your-value",
"MDB_MCP_LOGGERS": "your-value",
"MDB_MCP_MAX_ACTIVE_CONNECTIONS": "your-value",
"MDB_MCP_MAX_BYTES_PER_QUERY": "your-value",
"MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "your-value",
"MDB_MCP_MAX_SESSIONS": "your-value",
"MDB_MCP_MAX_TIME_M_S": "your-value",
"MDB_MCP_MCP_CLIENT_LOG_LEVEL": "your-value",
"MDB_MCP_MONITORING_SERVER_FEATURES": "your-value",
"MDB_MCP_MONITORING_SERVER_HOST": "your-value",
"MDB_MCP_MONITORING_SERVER_PORT": "your-value",
"MDB_MCP_NOTIFICATION_TIMEOUT_MS": "your-value",
"MDB_MCP_PREVIEW_FEATURES": "your-value",
"MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP": "your-value",
"MDB_MCP_QUERY_COUNT_TIMEOUT_MS": "your-value",
"MDB_MCP_READ_ONLY": "your-value",
"MDB_MCP_TELEMETRY": "your-value",
"MDB_MCP_TIMEOUT_MS": "your-value",
"MDB_MCP_TRANSPORT": "your-value",
"MDB_MCP_VOYAGE_API_KEY": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"mongodb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server"
],
"env": {
"MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP": "your-value",
"MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS": "your-value",
"MDB_MCP_ALLOW_REQUEST_OVERRIDES": "your-value",
"MDB_MCP_API_CLIENT_ID": "your-value",
"MDB_MCP_API_CLIENT_SECRET": "your-value",
"MDB_MCP_ASSISTANT_BASE_URL": "your-value",
"MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS": "your-value",
"MDB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
"MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS": "your-value",
"MDB_MCP_CONNECTION_SCOPE": "your-value",
"MDB_MCP_CONNECTION_STRING": "your-value",
"MDB_MCP_CONNECTION_STRINGS": "your-value",
"MDB_MCP_DANGEROUS_HOST_BINDING": "your-value",
"MDB_MCP_DISABLE_SERVER_SIDE_JS": "your-value",
"MDB_MCP_DISABLE_UNTRUSTED_DATA_WARNING": "your-value",
"MDB_MCP_DISABLED_TOOLS": "your-value",
"MDB_MCP_DRY_RUN": "your-value",
"MDB_MCP_ELICITATION_TIMEOUT_MS": "your-value",
"MDB_MCP_EVICTION_IDLE_GRACE_M_S": "your-value",
"MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS": "your-value",
"MDB_MCP_EXPORT_TIMEOUT_MS": "your-value",
"MDB_MCP_EXPORTS_PATH": "your-value",
"MDB_MCP_EXTERNALLY_MANAGED_SESSIONS": "your-value",
"MDB_MCP_HEALTH_CHECK_HOST": "your-value",
"MDB_MCP_HEALTH_CHECK_PORT": "your-value",
"MDB_MCP_HTTP_BODY_LIMIT": "your-value",
"MDB_MCP_HTTP_HEADERS": "your-value",
"MDB_MCP_HTTP_HOST": "your-value",
"MDB_MCP_HTTP_PORT": "your-value",
"MDB_MCP_HTTP_RESPONSE_TYPE": "your-value",
"MDB_MCP_IDLE_TIMEOUT_MS": "your-value",
"MDB_MCP_INDEX_CHECK": "your-value",
"MDB_MCP_LOG_PATH": "your-value",
"MDB_MCP_LOGGERS": "your-value",
"MDB_MCP_MAX_ACTIVE_CONNECTIONS": "your-value",
"MDB_MCP_MAX_BYTES_PER_QUERY": "your-value",
"MDB_MCP_MAX_DOCUMENTS_PER_QUERY": "your-value",
"MDB_MCP_MAX_SESSIONS": "your-value",
"MDB_MCP_MAX_TIME_M_S": "your-value",
"MDB_MCP_MCP_CLIENT_LOG_LEVEL": "your-value",
"MDB_MCP_MONITORING_SERVER_FEATURES": "your-value",
"MDB_MCP_MONITORING_SERVER_HOST": "your-value",
"MDB_MCP_MONITORING_SERVER_PORT": "your-value",
"MDB_MCP_NOTIFICATION_TIMEOUT_MS": "your-value",
"MDB_MCP_PREVIEW_FEATURES": "your-value",
"MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP": "your-value",
"MDB_MCP_QUERY_COUNT_TIMEOUT_MS": "your-value",
"MDB_MCP_READ_ONLY": "your-value",
"MDB_MCP_TELEMETRY": "your-value",
"MDB_MCP_TIMEOUT_MS": "your-value",
"MDB_MCP_TRANSPORT": "your-value",
"MDB_MCP_VOYAGE_API_KEY": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。
你的选择通过 Cookie 保存在这台设备上,无需账户。
需要你填写的值
MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAPenvDeprecated. Use `aggregationCountTimeoutMs` instead.MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MSenvThe maximum time in milliseconds for the count phase of aggregation operations. This is used to limit the time spent counting documents when determining if results were capped.MDB_MCP_ALLOW_REQUEST_OVERRIDESenvWhen set to true, allows configuration values to be overridden via request headers and query parameters.- Atlas API client ID for authentication. Required for running Atlas tools.
- Atlas API client secret for authentication. Required for running Atlas tools.
MDB_MCP_ASSISTANT_BASE_URLenvBase URL for the MongoDB Assistant API.MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MSenvTime in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.MDB_MCP_CONFIRMATION_REQUIRED_TOOLSenvComma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.MDB_MCP_CONNECTION_IDLE_TIMEOUT_MSenvMilliseconds a MongoDB connection may stay unused (no tool call touching it) before it is closed to release the underlying connection pool and its server-side state. Applied per connection regardless…MDB_MCP_CONNECTION_SCOPEenvVisibility 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 clo…- MongoDB connection string for direct database connections, exposed under the connectionId "preconfigured". Optional, if not set, you'll need to call the connect tool before interacting with MongoDB d…
- MongoDB connection strings keyed by name, as a JSON object (e.g. {"preconfigured": "mongodb://...", "analytics": "mongodb://..."}). Each name becomes a connectionId that the MongoDB tools can use dir…
MDB_MCP_DANGEROUS_HOST_BINDINGenvWhen set to true, allows binding the HTTP server (and monitoring server) to a non-loopback host such as 0.0.0.0, a LAN IP, or an empty host (all interfaces). Binding to a non-loopback host exposes th…MDB_MCP_DISABLE_SERVER_SIDE_JSenvWhen 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_DISABLE_UNTRUSTED_DATA_WARNINGenvWhen set to true, tool responses include potentially untrusted data (such as documents or query results) as-is, without wrapping it in delimiters and a prompt-injection warning.MDB_MCP_DISABLED_TOOLSenvComma separated values of tool names, operation types, and/or categories of tools that will be disabled.MDB_MCP_DRY_RUNenvWhen true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.MDB_MCP_ELICITATION_TIMEOUT_MSenvTime in milliseconds the user has to respond to an elicitation request (such as a tool confirmation prompt) before it fails.MDB_MCP_EVICTION_IDLE_GRACE_M_SenvHow long a session must be idle before it becomes eligible for least-recently-used eviction when the HTTP transport is at its maxSessions cap (only used when transport is 'http'). Swept back to idleT…MDB_MCP_EXPORT_CLEANUP_INTERVAL_MSenvTime in milliseconds between export cleanup cycles that remove expired export files.MDB_MCP_EXPORT_TIMEOUT_MSenvTime in milliseconds after which an export is considered expired and eligible for cleanup.MDB_MCP_EXPORTS_PATHenvFolder to store exported data files.MDB_MCP_EXTERNALLY_MANAGED_SESSIONSenvWhen true, the 2025-era HTTP transport accepts a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional, and an im…MDB_MCP_HEALTH_CHECK_HOSTenvDeprecated. 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_PORTenvDeprecated. 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_LIMITenvMaximum 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_HEADERSenvHeader that the HTTP server will validate when making requests (only used when transport is 'http').MDB_MCP_HTTP_HOSTenvHost address to bind the HTTP server to (only used when transport is 'http').MDB_MCP_HTTP_PORTenvPort number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.MDB_MCP_HTTP_RESPONSE_TYPEenvThe HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.MDB_MCP_IDLE_TIMEOUT_MSenvIdle timeout for a client to disconnect (only applies to http transport).MDB_MCP_INDEX_CHECKenvWhen set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.MDB_MCP_LOG_PATHenvFolder to store logs.MDB_MCP_LOGGERSenvComma separated values of logger types.MDB_MCP_MAX_ACTIVE_CONNECTIONSenvMaximum 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 connec…MDB_MCP_MAX_BYTES_PER_QUERYenvThe 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_QUERYenvThe 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_SESSIONSenvMaximum 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…MDB_MCP_MAX_TIME_M_SenvDeprecated. Use `timeoutMs` instead. The maximum time in milliseconds that operations are allowed to run on the MongoDB server.MDB_MCP_MCP_CLIENT_LOG_LEVELenvMinimum severity level for log messages forwarded to the MCP client.MDB_MCP_MONITORING_SERVER_FEATURESenvFeatures to expose on the monitoring server: health-check, metrics, and process-metrics. process-metrics exposes /metrics with Node.js process metrics (only used when transport is 'http' and monitori…MDB_MCP_MONITORING_SERVER_HOSTenvHost 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_PORTenvPort number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.MDB_MCP_NOTIFICATION_TIMEOUT_MSenvNotification timeout for a client to be aware of disconnect (only applies to http transport).MDB_MCP_PREVIEW_FEATURESenvComma separated values of preview features that are enabled.MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAPenvDeprecated. Use `queryCountTimeoutMs` instead.MDB_MCP_QUERY_COUNT_TIMEOUT_MSenvThe maximum time in milliseconds for the count phase of find operations. This is used to limit the time spent counting documents when determining if results were capped.MDB_MCP_READ_ONLYenvWhen set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.MDB_MCP_TELEMETRYenvWhen set to disabled, disables telemetry collection.MDB_MCP_TIMEOUT_MSenvThe maximum time in milliseconds that MongoDB operations are allowed to run, applied as the driver's timeoutMS (client-side operation timeout, CSOT) on each connection. It bounds the entire operation…MDB_MCP_TRANSPORTenvEither 'stdio' or 'http'.- API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它能做什么
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 mongodb-js 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于今天
- ✓ 通过
有许可证
使用 Apache-2.0
- – 不适用
端点有响应
它在你的电脑上运行,没有互联网端点
- – 不适用
使用 OAuth 登录
在你的电脑上运行,改用本地设置
- … 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行;我们只能读取互联网端点的工具列表
与“数据库与数据集”中的其他服务器比较i
- 星标数多于此分类中其他 1160 个服务器的 99%
- 发布到注册中心的时间比此分类中其他 1160 个服务器的 96% 更新
- 基础检查结果等于或优于此分类中其他 1160 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
MongoDB MCP Server 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
你需要填写:MDB_MCP_API_CLIENT_ID, MDB_MCP_API_CLIENT_SECRET, MDB_MCP_CONNECTION_STRING, MDB_MCP_CONNECTION_STRINGS, MDB_MCP_VOYAGE_API_KEY
它在我的电脑上运行还是在云端?
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
它还在维护吗?
GitHub 仓库最后更新于今天,最新版本(3.3.0)于昨天进入注册中心。
有什么可以替代它?
同一分类中有:Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
MongoDB MCP Server
A Model Context Protocol server for interacting with MongoDB Databases and MongoDB Atlas.
Quick Start
Using the official MongoDB plugins for AI agents
MongoDB MCP Server comes bundled with the official MongoDB plugins for AI agents. The following plugins are available:
`mongodb-atlas` — connects to the MongoDB-hosted Atlas MCP server over OAuth. This does not require you to run anything locally, and is the recommended way to connect to MongoDB Atlas from your AI agent:
- Cursor: marketplace
- VSCode: Open the Extensions view (
⇧⌘X/Ctrl+Shift+X), search for@agentPlugins, and installmongodb-atlas. - Claude: marketplace
- Codex: Open
/pluginsand installmongodb-atlas. - GitHub Copilot CLI: Run
copilot plugin install mongodb-atlas. - Grok: Open
/marketplacein Grok Build and installmongodb-atlas.
`mongodb` — runs the MongoDB MCP server locally and connects to any self-managed deployment:
- Cursor: marketplace
- Claude: marketplace
- Gemini: marketplace
- Codex: Run
codex plugin marketplace add mongodb/agent-skills, then open/pluginsand installmongodb. - GitHub Copilot CLI: Run
copilot plugin install mongodb. - Grok: Open
/marketplacein Grok Build and installmongodb.
Using the setup script
You can manually set up the local MCP server by running the following command:
npx -y mongodb-mcp-server@latest setup
This will guide you through an interactive setup process, including configuring your MongoDB connection string or Atlas API credentials.
For more advanced setup options, see the Manual Setup section below.
Using the MongoDB MCP Server setup skill
You can add and use the MongoDB MCP Server setup skill to configure your local MCP server using an AI agent.
npx skills add https://github.com/mongodb/agent-skills --skill mongodb-mcp-setup
Using manual configuration
See Manual Setup for instructions on how to manually configure the MongoDB MCP Server.
📚 Table of Contents
- 🚀 Getting Started
- Prerequisites
- Manual Setup
- 🛠️ Supported Tools
- MongoDB Atlas Tools
- MongoDB Database Tools
- MongoDB Assistant Tools
- 📄 Supported Resources
- ⚙️ Configuration
- Configuration Options
- Atlas API Access
- Configuration Methods
- Environment Variables
- Command-Line Arguments
- MCP Client Configuration
- Proxy Support
- 🚀 Deploy on Public Clouds
- Azure Cloud
- 🤝 Contributing
Prerequisites
[!NOTE]
Node 20.x support is deprecated and will be removed in a future release. Please upgrade to Node 22.13 or later. See https://nodejs.org/en/blog/migrations/v20-to-v22 for migration details.
- Node.js
- At least v22.13.0. Check with
node -v.
- A MongoDB connection string or Atlas API credentials.
- _Service Accounts Atlas API credentials_ are required to use the Atlas tools. You can create a service account in MongoDB Atlas and use its credentials for authentication. See Atlas API Access for more details.
- If you have a MongoDB connection string, you can use it directly to connect to your MongoDB instance.
Manual Setup
🔒 Security Recommendation 1: When using Atlas API credentials, be sure to assign only the minimum required permissions to your service account. See Atlas API Permissions for details.
🔒 Security Recommendation 2: For enhanced security, we strongly recommend using environment variables to pass sensitive configuration such as connection strings and API credentials instead of command line arguments. Command line arguments can be visible in process lists and logged in various system locations, potentially exposing your secrets. Environment variables provide a more secure way to handle sensitive information.
Most MCP clients require a configuration file to be created or modified to add the MCP server.
Note: The configuration file syntax can be different across clients. Please refer to the following links for the latest expected syntax:
Default Safety Notice: All examples below include
--readOnlyby default to ensure safe, read-only access to your data. Remove--readOnlyif you need to enable write operations.
Option 1: Connection String
You can pass your connection string via environment variables, make sure to use a valid username and password.
{
"mcpServers": { "MongoDB": { "command": "npx", "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"], "env": { "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase" } } } }
NOTE: The connection string can be configured to connect to any MongoDB cluster, whether it's a local instance or an Atlas cluster.
Option 2: Connect to the MongoDB Atlas-Managed MCP Server
When working with MongoDB Atlas, the recommended approach is to install the mongodb-atlas plugin for your AI agent, which handles OAuth authentication automatically.
For manual configuration, see the client-specific instructions for setting up the Atlas Remote MCP server with OAuth. Alternatively, you can connect using the mongodb-atlas-mcp-remote package with Service Account credentials — see the package README for setup instructions.
Note: You cannot authenticate to the remote MongoDB MCP server using a static API key over HTTP. You must either:
- Use a client that supports the OAuth flow.
- Use the
mongodb-atlas-mcp-remotestdio server, which you can authenticate into using the staticMDB_MCP_API_CLIENT_IDandMDB_MCP_API_CLIENT_SECRETenvironment variables.
To connect with the mongodb-atlas-mcp-remote stdio server using Service Account credentials, add it to your client's MCP configuration:
{
"mcpServers": { "mongodb-atlas-mcp-remote": { "type": "stdio", "command": "npx", "args": ["-y", "mongodb-atlas-mcp-remote@latest"], "env": { "MDB_MCP_API_CLIENT_ID": "$CLIENT_ID", "MDB_MCP_API_CLIENT_SECRET": "$SECRET" } } } }
Option 3: Atlas API Credentials
Use your Atlas API Service Accounts credentials. Must follow all the steps in Atlas API Access section.
{
"mcpServers": { "MongoDB": { "command": "npx", "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"], "env": { "MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id", "MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret" } } } }