MongoDB MCP 服务器

MongoDB MCP（MongoDB Command Line Process）服务器是一个功能强大的工具，支持通过命令行界面管理 MongoDB 数据库和 Atlas 云服务。以下是其详细功能列表及使用说明。

功能概述

工具列表

MCP 提供以下核心工具：

• MongoDB Shell: 直接与 MongoDB 数据库交互
• mongodump/mongorestore: 数据库备份与恢复
• mongoexport/mongoimport: 数据导入导出
• dbstats: 数据库统计信息查询
• replSetCommand: 副本集操作
• Atlas API Tools: 用于管理 MongoDB Atlas 资源

Atlas API 工具列表

以下是 MCP 提供的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"
      ]
    }
  }
}

Atlas API 使用说明

创建 MongoDB Atlas 用户

使用以下命令创建用户：

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

获取 MongoDBAtlas 数据库访问权限

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

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

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