MongoDB MCP 服务器安全最佳实践

JSON配置文件示例

以下示例在 Claude 桌面客户端应用程序的 MCP客户端JSON配置文件中显示 --readOnly：

{
   "mcpServers": {
      "MongoDB": {
         "type": "stdio",
         "command": "npx",
         "args": [
            "-y",
            "mongodb-mcp-server@latest",
            "--readOnly"
         ],
         "env": {
            "MDB_MCP_CONNECTION_STRING":
            "mongodb://localhost:27017/myDatabase"
         }
      }
   }
}

有关其他示例客户端JSON配置文件，请参阅配置 MCP 服务器。

命令行示例

以下示例在 Unix 环境变量中定义了 MCP 服务器连接字符串以连接到Atlas 集群：

export MDB_MCP_CONNECTION_STRING="mongodb://localhost:27017/myDatabase"

以下示例使用前面的环境变量，并设置了一个附加命令行选项：

npx -y mongodb-mcp-server@latest --readOnly

密钥和环境变量

对于登录凭证和连接信息等敏感配置设置，请使用环境变量而不是命令行参数。示例，使用 MDB_MCP_API_CLIENT_ID 和 MDB_MCP_API_CLIENT_SECRET 作为API客户端设置，使用 MDB_MCP_CONNECTION_STRING 作为连接字符串。

环境变量比命令行参数更安全。可以跟踪、缓存命令行参数，将其包含在进程列表中，并记录在各个位置。

以下示例将 MDB_MCP_READ_ONLY 环境变量设置为 true 并设置 MDB_MCP_CONNECTION_STRING 环境变量：

"MongoDB": {
   "type": "stdio",
   "command": "npx",
   "args": [
      "-y",
      "mongodb-mcp-server@latest",
   ],
   "env": {
      "MDB_MCP_READ_ONLY": "true",
      "MDB_MCP_CONNECTION_STRING":
      "mongodb://127.0.0.1:27019/?directConnection=true"
   }
}

有关环境变量的更多信息，请参阅在操作系统中定义 MCP 服务器环境变量。

本地 MCP 服务器

在本地 MCP 服务器中，MCP 服务器和客户端应用程序在同一台计算机上运行。

本地 MCP 服务器可以控制安装环境：

• 配置和依赖项：管理MCP 服务器软件依赖项。要定义 MCP 服务器参数和数据库连接，请编辑本地计算机上的文件。

• 档案安全： API密钥和连接字符串的敏感信息本地存储在配置文件或环境变量中。您可以保护凭证的安全。

• 手动软件更新：当有新的 MCP Server 版本可用时，用户可以下载并安装 MCP Server 软件。这可能会导致用户运行不同的 MCP 服务器版本。

远程 MCP 服务器

在远程 MCP Server部署中，MCP Server 在云中的计算机或本地部署服务器上运行。

客户端应用程序通过网络连接到 MCP 服务器，并使用 Streamable HTTP。这提供了一个可供多个用户、自动化系统、应用程序和AI代理访问的中央共享环境。

对于 MCP 服务器远程部署，请考虑以下几点：

• 远程部署存在额外的安全风险，需要安全配置。

• 您至少需要配置网络隔离性、对 MCP 服务器的身份验证，并在云或本地设立密钥管理。

委派授权

在委派授权中，用户将其权限的子集委派给代理。MongoDB建议将 OAuth 2.1 与 MCP 服务器结合使用。

要使用 MCP 服务器，部署必须具有受经过身份验证的用户帐户保护的 OAuth 授权服务器 (AS)，以及位于 MCP 服务器前面作为 OAuth 资源服务器 (RS) 运行的代理。该代理作为 OAuth客户端运行。

OAuth 委托的运行方式如下：

1. 代理请求访问权限MCP 服务器。MCP 服务器受代理保护。

2. Proxy 将代理发送到 AS，AS 启动授权请求

3. 用户登录到AS并授权代理访问权限RS，RS是保护MCP服务器的代理。

4. 为代理提供了访问权限令牌来访问权限RS。

5. 代理使用访问权限令牌通过代理调用 MCP 服务器。

6. 代理验证访问权限令牌并允许调用 MCP 服务器。

7. MCP 服务器接收代理请求，并通过静态配置的安全连接在数据库上运行命令。

MCP 服务器和数据库从不读取访问权限令牌。信任代理可以保护 MCP 服务器。绕过代理会导致访问权限MCP 服务器以及 MCP 服务器可以访问权限的数据库。

令牌的格式是隐藏的。JWT 是一种常见格式，允许代理独立验证 AS 颁发的令牌。

直接身份验证

不建议直接身份验证。

通过直接身份验证，代理会向代理提供凭证。代理对凭证进行身份验证。这些凭证可以是API密钥或其他标识代理的档案。该模式很简单，但存在以下问题：

• 仅识别代理，而不识别代理所代表的用户。

• 无法Atlas 审核谁通过 MCP 服务器执行了哪些动作。

• 通常集中控制所有用户的访问，或直接在代理上控制。

用户模拟

请勿使用用户模拟。

通过用户模拟，用户可以直接向代理提供凭证。代理将凭证发送给代理进行身份验证。用户模拟存在以下问题：

• 仅识别用户身份。代理代表用户行事的事实是隐藏的。

• 用户凭证泄露给中间系统。这会使用户帐户面临风险。

• 用户可以执行的动作对于代理来说是允许的，并且不可能发布有限的功能。

• 断开代理连接需要轮换用户凭证，这会扰乱用户帐户和系统。

• 不可进行网络钓鱼和不可重放的凭证无法运行。

直通身份验证

请勿使用直通身份验证。

在直通身份验证中，代理获取数据库访问权限凭证并将其传递给代理。代理验证凭证并将凭证传递给 MCP 服务器。MCP 服务器使用这些凭证连接数据库。传递身份验证存在以下问题：

• 只有可复制和可重放的凭证才能运行，这将连接限制为低安全选项。

• 连接链对系统是隐藏的。

• 任何人都有可能省略链的下一部分。

数据库身份验证和授权

MCP 服务器支持以下数据库身份验证方法：

• 使用LDAP、X.509 证书、OIDC 和Kerberos进行企业身份验证。

• 默认SCRAM-SHA-256身份验证提供强密码身份验证。

• 用于服务帐户和集群间通信的 mTLS 证书身份验证。

MongoDB 数据库支持以下授权方法：

• 用于限制数据库访问权限的RBAC。

• 精细的数据库权限，用于限制对特定数据库、单个集合的访问权限以及读取、写入和管理操作等操作。

• 团队的自定义数据库角色。示例，分析团队的只读访问权限和运营团队的读写访问访问权限。

• 用于限制集合访问权限的额外集合安全性。

网络安全

网络隔离性建议：

• 在私有VPC或VNet中部署集群，无需直接访问权限互联网。

• 通过VPC对等互联和私有端点安全连接到云专用网络。

• 将数据库访问权限限制为特定IP地址或 CIDR 区块。

防火墙配置建议：

• 仅允许授权的应用程序服务器访问权限MongoDB服务器端口 27017。

• 使用安全组和ACL为传入和传出网络流量配置云防火墙规则。

• 禁用非加密端口并为所有连接实施TLS 1.2+。