MongoDB
让智能体访问 MongoDB 数据库并使用 MongoDB Atlas 工具。 摘要由 AI Index 撰写。
Registry 描述:MongoDB Model Context Protocol Server
添加到你的客户端
把 MongoDB MCP 服务器添加到 Claude Code
运行命令
claude mcp add mongodb -- npx -y mongodb-mcp-server填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Cursor
打开 mcp.json· 文件位置:
~/.cursor/mcp.json,.cursor/mcp.json粘贴服务器配置
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 VS Code
打开 mcp.json· 文件位置:
.vscode/mcp.json粘贴服务器配置
{ "servers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Codex
运行命令
codex mcp add mongodb -- npx -y mongodb-mcp-server填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Devin Desktop
打开 mcp_config.json· 文件位置:
~/.config/devin/mcp_config.json,%APPDATA%\devin\mcp_config.json粘贴服务器配置
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Gemini CLI
打开 settings.json· 文件位置:
~/.gemini/settings.json,.gemini/settings.json粘贴服务器配置
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 GitHub Copilot
运行命令
copilot mcp add mongodb -- npx -y mongodb-mcp-server填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Cline
打开 cline_mcp_settings.json· 文件位置:
~/.cline/data/settings/cline_mcp_settings.json粘贴服务器配置
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Kiro
打开 mcp.json· 文件位置:
.kiro/settings/mcp.json,~/.kiro/settings/mcp.json粘贴服务器配置
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 Zed
打开 settings.json
粘贴服务器配置
{ "context_servers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ], "env": {} } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 OpenCode
打开 opencode.json· 文件位置:
~/.config/opencode/opencode.json,opencode.json粘贴服务器配置
{ "$schema": "https://opencode.ai/config.json", "mcp": { "mongodb": { "type": "local", "command": [ "npx", "-y", "mongodb-mcp-server" ], "enabled": true } } }填写取值 ↓
确认已连接
把 MongoDB MCP 服务器添加到 JetBrains AI Assistant
打开 JetBrains AI Assistant 的 MCP 配置
- 打开 Settings | Tools | AI Assistant | Model Context Protocol (MCP)。
- 选择 Add。
粘贴服务器配置
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mongodb-mcp-server" ] } } }填写取值 ↓
确认已连接
如果文件里已有其他服务器,把这一项加到已有的对象里。 确认是否已连接:重启或重新加载客户端,在它的 MCP 服务器列表里找到 mongodb。需要登录的服务器会在第一次使用时打开登录。
需要填写的值
必填项以 <NAME> 占位符出现在片段里;可选项按同样方式添加。说明来自服务器在 Registry 里的条目。
<MDB_MCP_AGGREGATION_COUNT_MAX_TIME_MS_CAP>环境变量 可选Deprecated. Use `aggregationCountTimeoutMs` instead.
<MDB_MCP_AGGREGATION_COUNT_TIMEOUT_MS>环境变量 可选The 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_OVERRIDES>环境变量 可选When set to true, allows configuration values to be overridden via request headers and query parameters.
<MDB_MCP_API_CLIENT_ID>环境变量 可选 · 密钥Atlas API client ID for authentication. Required for running Atlas tools.
<MDB_MCP_API_CLIENT_SECRET>环境变量 可选 · 密钥Atlas API client secret for authentication. Required for running Atlas tools.
<MDB_MCP_ASSISTANT_BASE_URL>环境变量 可选Base URL for the MongoDB Assistant API.
<MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS>环境变量 可选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>环境变量 可选Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.
<MDB_MCP_CONNECTION_IDLE_TIMEOUT_MS>环境变量 可选Milliseconds 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 of its connection scope; the preconfigured connection is excluded, and the reaper runs on this cadence. Set to 0 to disable reaping; must not be negative.
<MDB_MCP_CONNECTION_SCOPE>环境变量 可选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. With 'global', connections are shared across all sessions and survive session rotation. Deprecated: the MCP protocol is moving to sessionless, so this option will soon be removed and the connection scope will default to 'global'. For shared-server use cases, use the Atlas-Managed MCP server or build an authenticated library using the @mongodb-js/mcp-cli package. Note: on the sessionless (2026-07-28) HTTP path, a request without an mcp-session-id falls back to the shared ('global') scope so it can still persist connections across requests; the legacy sessionful path always carries a server-issued session.
<MDB_MCP_CONNECTION_STRING>环境变量 可选 · 密钥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 data. Deprecated: prefer the "preconfigured" entry of connectionStrings.
<MDB_MCP_CONNECTION_STRINGS>环境变量 可选 · 密钥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 directly, so one server can reach several deployments. Connections are opened on first use. Environment variable or config file only.
<MDB_MCP_DANGEROUS_HOST_BINDING>环境变量 可选When 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 the server to the entire network and can allow unauthorized access. Off by default: the server refuses to start on a non-loopback host unless this is true.
<MDB_MCP_DISABLE_SERVER_SIDE_JS>环境变量 可选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_DISABLE_UNTRUSTED_DATA_WARNING>环境变量 可选When 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_TOOLS>环境变量 可选Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.
<MDB_MCP_DRY_RUN>环境变量 可选When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.
<MDB_MCP_ELICITATION_TIMEOUT_MS>环境变量 可选Time 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_S>环境变量 可选How 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 idleTimeoutMs when larger.
<MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS>环境变量 可选Time in milliseconds between export cleanup cycles that remove expired export files.
<MDB_MCP_EXPORT_TIMEOUT_MS>环境变量 可选Time in milliseconds after which an export is considered expired and eligible for cleanup.
<MDB_MCP_EXPORTS_PATH>环境变量 可选Folder to store exported data files.
<MDB_MCP_EXTERNALLY_MANAGED_SESSIONS>环境变量 可选When 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 implicitly re-initialized session restores the client's previously negotiated capabilities from the session store.
<MDB_MCP_HEALTH_CHECK_HOST>环境变量 可选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>环境变量 可选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>环境变量 可选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>环境变量 可选Header that the HTTP server will validate when making requests (only used when transport is 'http').
<MDB_MCP_HTTP_HOST>环境变量 可选Host address to bind the HTTP server to (only used when transport is 'http').
<MDB_MCP_HTTP_PORT>环境变量 可选Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.
<MDB_MCP_HTTP_RESPONSE_TYPE>环境变量 可选The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.
<MDB_MCP_IDLE_TIMEOUT_MS>环境变量 可选Idle timeout for a client to disconnect (only applies to http transport).
<MDB_MCP_INDEX_CHECK>环境变量 可选When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.
<MDB_MCP_LOG_PATH>环境变量 可选Folder to store logs.
<MDB_MCP_LOGGERS>环境变量 可选Comma separated values of logger types.
<MDB_MCP_MAX_ACTIVE_CONNECTIONS>环境变量 可选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.
<MDB_MCP_MAX_BYTES_PER_QUERY>环境变量 可选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>环境变量 可选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>环境变量 可选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>环境变量 可选Deprecated. Use `timeoutMs` instead. The maximum time in milliseconds that operations are allowed to run on the MongoDB server.
<MDB_MCP_MCP_CLIENT_LOG_LEVEL>环境变量 可选Minimum severity level for log messages forwarded to the MCP client.
<MDB_MCP_MONITORING_SERVER_FEATURES>环境变量 可选Features 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 monitoringServerHost/monitoringServerPort are set).
<MDB_MCP_MONITORING_SERVER_HOST>环境变量 可选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>环境变量 可选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>环境变量 可选Notification timeout for a client to be aware of disconnect (only applies to http transport).
<MDB_MCP_PREVIEW_FEATURES>环境变量 可选Comma separated values of preview features that are enabled.
<MDB_MCP_QUERY_COUNT_MAX_TIME_MS_CAP>环境变量 可选Deprecated. Use `queryCountTimeoutMs` instead.
<MDB_MCP_QUERY_COUNT_TIMEOUT_MS>环境变量 可选The 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_ONLY>环境变量 可选When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.
<MDB_MCP_TELEMETRY>环境变量 可选When set to disabled, disables telemetry collection.
<MDB_MCP_TIMEOUT_MS>环境变量 可选The 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, including server selection and network round trips.
<MDB_MCP_TRANSPORT>环境变量 可选Either 'stdio' or 'http'.
<MDB_MCP_VOYAGE_API_KEY>环境变量 可选 · 密钥API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).
客户端兼容性
按传输方式判断:客户端文档列出的传输方式里是否有这个服务器提供的。不涉及登录等其他要求。
- Claude Code 支持该传输方式
- Cursor 支持该传输方式
- VS Code 客户端文档未列出传输方式
- Codex 支持该传输方式
- Devin Desktop 支持该传输方式
- Gemini CLI 支持该传输方式
- GitHub Copilot 客户端文档未列出传输方式
- Cline 支持该传输方式
- Kiro 支持该传输方式
- Zed 客户端文档未列出传输方式
- OpenCode 客户端文档未列出传输方式
- JetBrains AI Assistant 支持该传输方式
- Claude 客户端文档未列出传输方式
- ChatGPT 没有共同的传输方式
来源
- Official MCP Registry registry.modelcontextprotocol.io · 核对于 2026年11月4日
- MongoDB: vendor documentation mongodb.com · 核对于 2026年11月8日
This data comes from the Official MCP Registry.