MongoDB Atlas MCP 服务器

用于管理 MongoDB Atlas 项目的 MCP (模型上下文协议) 服务器。此软件包提供了通过 MCP 接口创建和管理 MongoDB Atlas 集群、用户和网络访问的工具。

演示视频

观看演示视频，了解 MongoDB Atlas MCP 服务器的实际应用。

功能

MCP 工具

• create_atlas_cluster - 在现有项目中创建一个新的 MongoDB Atlas 集群
• setup_atlas_network_access - 配置 Atlas 项目的网络访问
• create_atlas_user - 创建一个具有 atlasAdmin 角色的新数据库用户
• get_atlas_connection_strings - 检索集群的连接字符串
• list_atlas_projects - 列出使用提供的 API 密钥可以访问的所有 Atlas 项目
• list_atlas_clusters - 列出特定 Atlas 项目中的所有集群

安装

npm install mcp-mongodb-atlas

用法

作为命令行工具

您可以直接从命令行运行 Atlas 项目管理器：

# 使用环境变量
export ATLAS_PUBLIC_KEY="your-public-key"
export ATLAS_PRIVATE_KEY="your-private-key"
npx mcp-mongodb-atlas

# 或者将密钥作为参数传递
npx mcp-mongodb-atlas "your-public-key" "your-private-key"

与 Cline (VSCode 扩展) 一起使用

要在 VSCode 中与 Cline 一起使用，请将服务器配置添加到您的 MCP 设置文件中：

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

MCP 设置文件位于：

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

与 Cursor 一起使用

要与 Cursor 一起使用，请转到设置中的“Cursor settings” > “MCP”，然后添加一个具有以下配置的新服务器：

1. 名称: atlas (或您喜欢的任何名称)
2. 命令: npx mcp-mongodb-atlas
3. 参数: 将您的 API 密钥作为参数提供

## 建议的命令
npx mcp-mongodb-atlas <public_key> <private_key>

较新版本可以使用以下内容设置 ~/.cursor/mcp.json 文件：

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

4. 环境变量 (可选):
   • ATLAS_PUBLIC_KEY: 您的 MongoDB Atlas 公钥
   • ATLAS_PRIVATE_KEY: 您的 MongoDB Atlas 私钥

与 Claude Desktop 一起使用

要与 Claude Desktop 一起使用，请添加服务器配置：

在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

API 密钥

您需要 MongoDB Atlas API 密钥才能使用此工具。要创建 API 密钥：

1. 登录到您的 MongoDB Atlas 帐户
2. 转到 Access Manager > API Keys
3. 创建具有适当权限的新 API 密钥
4. 保存公钥和私钥

开发

克隆存储库并安装依赖项：

git clone https://github.com/mongodb-developer/mcp-mongodb-atlas.git
cd mcp-mongodb-atlas
npm install

构建项目：

npm run build

对于具有自动重建功能的开发：

npm run watch

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

许可证

MIT