项目简介
该项目实现了一个Model Context Protocol (MCP) 服务器,专注于MongoDB Atlas云数据库的管理。它提供了一系列工具,允许LLM客户端通过标准化的MCP协议,安全地管理MongoDB Atlas上的资源,例如创建和管理数据库集群、配置网络访问以及管理数据库用户。
主要功能点
- 集群管理: 支持创建新的MongoDB Atlas集群、列出指定项目下的所有集群、以及获取集群的连接字符串。
- 网络访问配置: 允许配置MongoDB Atlas项目的网络访问列表,添加或移除允许访问集群的IP地址。
- 用户管理: 支持在MongoDB Atlas项目中创建新的数据库用户,并赋予 'atlasAdmin' 角色。
安装步骤
- 确保你的开发环境中已安装 Node.js 和 npm。
- 克隆该 GitHub 仓库到本地:
git clone https://github.com/mongodb-developer/mcp-mongodb-atlas.git cd mcp-mongodb-atlas - 安装项目依赖:
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 资源的权限。
信息
分类
数据库与文件