Docs 菜单
Docs 主页
/
MongoDB MCP 服务器
/
配置

MongoDB MCP 服务器配置选项

MCP Server 具有多个可设立的选项，用于连接到MongoDB 集群并控制 MCP Server 操作。您可以通过命令行或使用操作系统环境变量在JSON配置文件中设立选项。

选项列表

使用以下配置选项配置 MCP 服务器。

重要

如果您是MongoDB Enterprise或MongoDB Atlas用户并且需要特定的身份验证机制，请参阅 MongoDB MCP 服务器安全性 部分，学习；了解身份验证方法的配置选项。

CLI选项名称
操作系统环境变量名称
类型
默认
说明

apiClientId

MDB_MCP_API_CLIENT_ID

字符串

未设立

用于身份验证的Atlas API客户端ID 。

apiClientSecret

MDB_MCP_API_CLIENT_SECRET

字符串

未设立

用于身份验证的Atlas API客户端密钥。

connectionString

MDB_MCP_CONNECTION_STRING

字符串

未设立

直接数据库连接的连接字符串。

在运行时设置连接字符串，以允许客户端直接连接到集群。

重要

--connectionString CLI参数已弃用。请改用 MDB_MCP_CONNECTION_STRING 环境变量。如果没有环境变量，请使用第一个位置参数。

注意

通常，避免在运行时提供连接字符串，因为这会向大语言模型公开连接凭证。

如果客户端以前从未连接过，则使用该连接字符串；如果客户端以前已连接过，则客户端会将连接切换到新集群。

客户端调用连接或切换连接工具后，客户端会重复使用同一连接进行后续操作。因此，如果需要切换到其他连接，则只需调用 connect 或 swtich 连接工具一次。

loggers

MDB_MCP_LOGGERS

字符串

disk mcp

指定 MCP 服务器将日志发送到的位置。

将 loggers 设置为以下一个或多个选项：

  • disk，它将日志写入位于 logPath 选项指定路径中的磁盘文件。

  • mcp，如果客户端支持日志记录和传输协议，它将日志发送到AI客户端。

  • stderr，它将日志发送到标准错误输出。此设置对于调试或在容器中运行MCP 非常有用。

示例，要在AI客户端JSON配置文件或操作系统命令行loggers设立为 mcp 和 stderr，请使用 --loggers mcp stderr。

要将 MDB_MCP_LOGGERS 操作系统环境变量设立为 disk 和 stderr，请使用 export MDB_MCP_LOGGERS="disk,stderr"。

有关日志记录选项的更多信息，请参阅MongoDB MCP Server 故障排除。

logPath

MDB_MCP_LOG_PATH

字符串

取决于操作系统

存储 MCP 服务器日志的目录。

有关日志路径和操作系统细节的更多信息，请参阅MongoDB MCP Server 故障排除。

disabledTools

MDB_MCP_DISABLED_TOOLS

阵列

未设立

要禁用的 MCP 工具名称、操作类型或工具类别的大量。

有关更多信息，请参阅禁用 MCP 服务器工具。

readOnly

MDB_MCP_READ_ONLY

布尔

false

要禁用集群写入操作，请在配置文件或命令行中设立--readOnly，或将 MDB_MCP_READ_ONLY 操作系统环境变量设立为 true。

默认允许集群写入操作。通常，始终启用只读模式。

有关更多信息，请参阅启用 MCP 服务器只读模式。

indexCheck

MDB_MCP_INDEX_CHECK

布尔

false

如果为 true，则强制查询操作必须使用索引，并拒绝执行集合扫描的查询。

有关更多信息，请参阅启用索引检查。

telemetry

MDB_MCP_TELEMETRY

字符串

enabled

如果为 disabled，则停止集合MCP 服务器使用情况数据。

有关更多信息，请参阅禁用 MCP 服务器遥测。

transport

MDB_MCP_TRANSPORT

字符串

stdio

用于与 MCP 服务器通信的传输协议。

将 transport 设置为以下选项之一：

  • stdio，这是默认。使用标准输入和输出与 MCP 服务器进行通信。stdio 适用于大多数AI客户端。

  • http，这将启用与 MCP 服务器的HTTP通信。然后，您可以使用HTTP从 Web客户端与 MCP 服务器交互，或与特定HTTP IP端口上的 MCP 服务器通信。

    警告

    在未实施适当的身份验证和安全措施的情况下，不建议将HTTP传输用于生产用途。

httpPort

MDB_MCP_HTTP_PORT

整型

3000

与 MCP 服务器进行HTTP通信的IP端口号。

httpHost

MDB_MCP_HTTP_HOST

字符串

127.0.0.1

与 MCP 服务器进行HTTP通信的IP解决。

使用 Streamable HTTP时，MCP 服务器默认绑定到 localhost (127.0.0.1)。这可确保 MCP 服务器仅接受源自同一计算机的连接。

警告

绑定到 0.0.0.0 会将 MCP 服务器公开给整个本地网络，从而允许同一网络上的其他设备访问权限MCP 服务器。这是一个安全风险，可能允许未经授权访问权限您的数据库上下文。如果必须在 localhost 之外公开 MCP 服务器，实现强安全身份验证。

要学习；了解更多信息，请参阅远程连接。

idleTimeoutMs

MDB_MCP_IDLE_TIMEOUT_MS

整型

600000

客户端断开连接的空闲超时时间。仅适用于HTTP传输。

notificationTimeoutMs

MDB_MCP_NOTIFICATION_TIMEOUT_MS

整型

540000

客户端了解断开连接的通知超时时间。仅适用于HTTP传输。

authenticationMechanism

MDB_MCP_AUTHENTICATION_MECHANISM

字符串

SCRAM-SHA-256

SCRAM是MongoDB的默认身份验证机制。要使用其他身份验证方法通过MongoDB MCP服务器连接到MongoDB部署，请参阅以下页面：

exportsPath

MDB_MCP_EXPORTS_PATH

字符串

取决于操作系统

存储导出的数据文件的目录。

有关导出路径和操作系统细节的更多信息，请参阅从MongoDB MCP 服务器导出数据。

exportTimeoutMs

MDB_MCP_EXPORT_TIMEOUT_MS

整型

300000

以毫秒为单位的时间，在此时间过后，MCP 服务器清理进程可以删除导出的数据文件。

exportCleanupIntervalMs

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS

整型

120000

自动执行 MCP 服务器清理进程（删除过期导出数据文件）之间的时间段（以毫秒为单位）。清理进程会自动运行。

位置参数

MCP 服务器接受无需指定CLI标志即可提供的位置参数。第一个位置参数被解释为MongoDB 部署的连接字符串。

作为安全最佳实践，请使用 MDB_MCP_CONNECTION_STRING 环境变量设立连接字符串。 如果没有环境变量，请使用第一个位置参数。示例：

"args": [
   "-y",
   "mongodb-mcp-server",
   "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/",
   "--readOnly"
]

了解详情

后退

配置

来年

方法

在此页面上