MongoDB Atlas MCP 服务器

一个用于管理 MongoDB Atlas 项目的 MCP（Model Context Protocol）服务器。此包提供了通过 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 项目管理器：

# Using environment variables
export ATLAS_PUBLIC_KEY="your-public-key"
export ATLAS_PRIVATE_KEY="your-private-key"
npx mcp-mongodb-atlas

# Or passing keys as arguments
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 设置”>“MCP”，并按以下配置添加一个新的服务器：

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

## Suggested Command
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": []
    }
  }
}

1. 环境变量（可选）:
   • 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. 转到访问管理器 > API 密钥
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 服务器通过标准输入输出通信，调试可能比较困难。我们建议使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL，以便您在浏览器中访问调试工具。

许可证

MIT