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 相關的命令：

• mongoatlas clusters list：列出所有集群。
• mongoatlas projects list：列出所有項目。
• mongoatlas dbs.list：獲取數據庫列表。
• mongoatlas users.list：獲取用戶列表。
• mongoatlas metrics.getClusterMetrics：獲取集群性能指標。

📦 安裝指南

此文檔未提及安裝步驟，故跳過該章節。

💻 使用示例

基礎用法

創建 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>

高級用法

創建新數據庫

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

📚 詳細文檔

配置方法

環境變量配置

設置環境變量時，需使用前綴 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>

獲取 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。

如需更多信息，請參考官方文檔或聯繫技術支持。