Atlas MCP Server Wr3

🚀 MongoDB MCP 服务器

MongoDB MCP（MongoDB Command Line Process）服务器是一款功能强大的工具，可通过命令行界面实现对 MongoDB 数据库和 Atlas 云服务的管理，为数据库管理工作带来了极大的便利。以下将详细介绍其功能及使用方法。

🚀 快速开始

MongoDB MCP 服务器支持通过命令行界面管理 MongoDB 数据库和 Atlas 云服务。你可以按照后续的配置方法进行设置，然后使用提供的各种工具和命令开展数据库管理工作。

✨ 主要特性

工具列表

MCP 提供了一系列核心工具，涵盖了数据库交互、备份恢复、数据导入导出等多个方面：

• MongoDB Shell：能够直接与 MongoDB 数据库进行交互。
• mongodump/mongorestore：用于数据库的备份与恢复操作。
• mongoexport/mongoimport：可实现数据的导入和导出。
• dbstats：支持数据库统计信息的查询。
• replSetCommand：可进行副本集操作。
• Atlas API Tools：专门用于管理 MongoDB Atlas 资源。

Atlas API 工具列表

MCP 还提供了一系列与 Atlas 相关的命令，方便对 Atlas 资源进行管理：

• mongoatlas clusters list：列出所有集群。
• mongoatlas projects list：列出所有项目。
• mongoatlas dbs.list：获取数据库列表。
• mongoatlas users.list：获取用户列表。
• mongoatlas metrics.getClusterMetrics：获取集群性能指标。

📦 安装指南

本部分文档未提及安装步骤，若有相关需求，请参考官方文档或联系技术支持。

💻 使用示例

基础用法

配置环境变量

设置环境变量时，需使用前缀 MDB_MCP_ 加上大写的选项名称：

# 设置 Atlas API 凭证
export MDB_MCP_API_CLIENT_ID="your-atlas-client-id"
export MDB_MCP_API_CLIENT_SECRET="your-atlas-client-secret"

# 设置自定义 MongoDB 连接字符串
export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase"

# 设置日志路径
export MDB_MCP_LOG_PATH="/path/to/logs"

MCP 配置文件示例

• 使用环境变量的连接字符串配置：

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      }
    }
  }
}

• 使用环境变量的 Atlas API 凭证配置：

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server"],
      "env": {
        "MDB_MCP_API_CLIENT_ID": "your-atlas-client-id",
        "MDB_MCP_API_CLIENT_SECRET": "your-atlas-client-secret"
      }
    }
  }
}

命令行参数配置

通过命令行传递配置选项：

npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret="your-atlas-client-secret" --connectionString="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" --logPath=/path/to/logs

MCP 配置文件示例

• 使用命令行参数的连接字符串配置：

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      ]
    }
  }
}

• 使用命令行参数的 Atlas API 凭证配置：

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--apiClientId",
        "your-atlas-client-id",
        "--apiClientSecret",
        "your-atlas-client-secret"
      ]
    }
  }
}

高级用法

创建 MongoDB Atlas 用户

使用以下命令创建用户：

mongoatlas users.create --projectId <PROJECT_ID> \
--email <EMAIL> \
--username <USERNAME> \
--password <PASSWORD>

获取 MongoDB Atlas 数据库访问权限

获取数据库读写权限的命令如下：

mongoatlas dbusers.grantAccess --projectId <PROJECT_ID> \
--db <DATABASE_NAME> \
--user <USERNAME>

📚 详细文档

项目贡献指南

如果您希望为 MongoDB MCP 项目做出贡献，请参考以下步骤：

1. 克隆仓库：

git clone https://github.com/mongodb/mongo-mcp.git

2. 安装依赖项：

npm install

3. 运行测试：

npm test

问题反馈

如遇任何问题，请访问 MongoDB MCP 项目主页 提交 issue。

附录：常用命令示例

创建新数据库

mongo --db <DATABASE_NAME> --eval 'db.createDatabase(<DATABASE_NAME>)'

删除指定数据库

mongo --db <DATABASE_NAME> --eval 'db.dropDatabase()'

MongoDB 备份

mongodump --db <DATABASE_NAME> --out /path/to/backup

MongoDB 恢复

mongorestore --db <DATABASE_NAME> /path/to/backup/<DATABASE_NAME>. BSON

如需更多信息，请参考官方文档或联系技术支持。