项目简介

该项目实现了一个Model Context Protocol (MCP) 服务器,专注于MongoDB Atlas云数据库的管理。它提供了一系列工具,允许LLM客户端通过标准化的MCP协议,安全地管理MongoDB Atlas上的资源,例如创建和管理数据库集群、配置网络访问以及管理数据库用户。

主要功能点

  • 集群管理: 支持创建新的MongoDB Atlas集群、列出指定项目下的所有集群、以及获取集群的连接字符串。
  • 网络访问配置: 允许配置MongoDB Atlas项目的网络访问列表,添加或移除允许访问集群的IP地址。
  • 用户管理: 支持在MongoDB Atlas项目中创建新的数据库用户,并赋予 'atlasAdmin' 角色。

安装步骤

  1. 确保你的开发环境中已安装 Node.js 和 npm。
  2. 克隆该 GitHub 仓库到本地:
    git clone https://github.com/mongodb-developer/mcp-mongodb-atlas.git
    cd mcp-mongodb-atlas
  3. 安装项目依赖:
    npm install

服务器配置

要将此 MCP 服务器与 MCP 客户端(如 Cline, Cursor 或 Claude Desktop)配合使用,你需要在客户端的 MCP 服务器配置中添加以下信息。请注意,你需要将 'your-public-key' 和 'your-private-key' 替换为你的 MongoDB Atlas API 密钥。

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",  // 替换为你的 MongoDB Atlas 公钥
        "ATLAS_PRIVATE_KEY": "your-private-key" // 替换为你的 MongoDB Atlas 私钥
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置参数说明:

  • 'command': 启动 MCP 服务器的命令,这里使用 'npx mcp-mongodb-atlas' 来运行安装在 'node_modules' 中的 'mcp-mongodb-atlas' 包。
  • 'args': 传递给启动命令的参数,这里为空数组,API 密钥通过 'env' 环境变量传递,也可以选择将 API 密钥作为命令行参数添加到 'args' 数组中。
  • 'env': 环境变量配置,用于设置 MongoDB Atlas API 的公钥 ('ATLAS_PUBLIC_KEY') 和私钥 ('ATLAS_PRIVATE_KEY')。强烈建议使用环境变量或命令行参数的方式传递密钥,避免硬编码在配置文件中。

基本使用方法

配置完成后,当你在 MCP 客户端中与 LLM 交互时,可以指示 LLM 使用此 MCP 服务器提供的工具来管理 MongoDB Atlas 资源。例如,你可以要求 LLM "创建一个 MongoDB Atlas 集群" 或 "列出我的 MongoDB Atlas 项目",LLM 就会调用此 MCP 服务器提供的相应工具来完成操作。

注意: 使用此 MCP 服务器需要配置有效的 MongoDB Atlas API 密钥,请确保你的 API 密钥具有操作 MongoDB Atlas 资源的权限。

信息

分类

数据库与文件