Atlas MCP 服务器

一个用于与 MongoDB Atlas 交互的模型上下文协议服务器。本项目实现了一个模型上下文协议 (MCP) 服务器，使 AI 助手能够通过自然语言与 MongoDB Atlas 资源进行交互。

📚 目录

• 🚀 快速开始
  • 前提条件
  • 安装
  • 运行 MCP 服务器
• 🛠️ 支持的工具
  • 工具列表
• 👩‍💻 客户端集成
  • VSCode
  • Claude
• 🤝 贡献

🚀 快速开始

前提条件

• Node.js (v23 或更高版本)
• MongoDB Atlas 账户

安装

# 克隆仓库
git clone https://github.com/mongodb-labs/mongodb-mcp-server.git
cd mongodb-mcp-server

# 安装依赖
npm install

运行 MCP 服务器

npm run build

🛠️ 支持的工具

工具列表

• auth - 验证 MongoDB Atlas 的身份
• list-clusters - 列出 MongoDB Atlas 集群
• list-projects - 列出 MongoDB Atlas 项目

👩‍💻 客户端集成 (使用服务器!)

VSCode

前提条件：

• 使用 VSCode Insiders (https://code.visualstudio.com/insiders/)
• 在 VSCode Insiders 中设置 Copilot

步骤 1：将 MCP 服务器添加到 VSCode 配置

• 按 Cmd + Shift + P 并输入 MCP: Add MCP Server 并选择它。
• 选择第一个选项，用于本地 MCP 服务器。
• 在提示符中添加 dist/index.js 的路径

步骤 2：验证创建的 mcp 文件

它应该看起来像这样

{
  "servers": {
    "mongodb-mcp-server": {
      "type": "stdio",
      "command": "/Users/<user>/workplace/atlas-mcp-server/dist/index.js",
      "args": []
    }
  }
}

步骤 3：打开 Copilot 聊天，并检查工具箱图标是否可见，并且列出了 MCP 服务器。

步骤 4：尝试运行命令

• 你能列出我的集群吗？

Claude

步骤 1：安装 Claude 并登录

brew install claude

步骤 2：为您的 MCP 服务器创建一个配置文件

打开文件

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

将 MCP 服务器配置粘贴到文件中

{
  "mcpServers": {
    "Demo": {
      "command": "path/to/this/repo/atlas-mc-server/dist/index.js"
    }
  }
}

步骤 3：启动 Claude Desktop 并单击锤子图标，应该会检测到 Demo MCP 服务器。在聊天中输入“show me a demo of MCP”并允许该工具获取访问权限。

• 带有屏幕截图的详细说明可以在此文档中找到。

注意：如果您更改了 MCP 服务器代码，请使用 npm run build 重建项目，然后重新启动服务器和 Claude Desktop。

🤝 贡献

有兴趣贡献吗？太棒了！请查看我们的贡献指南，了解有关代码贡献、标准、添加新工具和故障排除信息的指南。