360 Secure SkillHub
360 安全技能中心

MongoDB Atlas

该 Skill 通过 node 脚本浏览 MongoDB Atlas Admin API 的 OpenAPI 规范(列目录、查端点、查 Schema)。若配置了 ATLAS_CLIENT_ID 与 ATLAS_CLIENT_SECRET,还可对 Atlas 发起真实管理 API 请求;对写操作要求先 --dry-run 预览、经用户确认后再加 --yes 执行。

finishy1995
finishy1995
热度 74.82
最近更新 2026-05-17 11:49:24
分类:开发依赖:代码执行 / 读写文件 / 第三方 API应用场景:API 集成 / DevOps / 自动化脚本

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add mongodb-atlas-admin
Metadata
name
mongodb-atlas
description
browse MongoDB Atlas Admin API specifications and execute operations (if credentials provided).
homepage
https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/
metadata
{"clawdbot":{"emoji":"🍃","requires":{"bins":["node"],"env":["ATLAS_CLIENT_ID","ATLAS_CLIENT_SECRET"]},"primaryEnv":""}}

MongoDB Atlas Admin API

Tool to browse OpenAPI specifications for MongoDB Atlas. Note: If ATLAS_CLIENT_ID and ATLAS_CLIENT_SECRET are configured in the environment, this tool can also execute live API calls. Without credentials, it functions as a read-only documentation browser.

Commands

1. List API Catalog

List all available API categories or filter by keyword.

node {baseDir}/scripts/atlas-api.mjs catalog # list all categories
node {baseDir}/scripts/atlas-api.mjs catalog Clusters

2. Get API Details

Get full endpoint definition (method, path, params) for a specific Operation ID.

node {baseDir}/scripts/atlas-api.mjs detail listClusterDetails

3. Get Schema Definition

Get the data model schema for complex types.

node {baseDir}/scripts/atlas-api.mjs schema "#/components/schemas/ApiError"

4. Execute Live API Calls

Execute real HTTP requests against the Atlas API.

Script: node {baseDir}/scripts/atlas-call.mjs <METHOD> <ENDPOINT> [flags]

⚠️ Mandatory Safety Protocol

For any state-changing operation (POST, PUT, PATCH, DELETE):

  1. STOP & REVIEW: You MUST NOT execute the command immediately.
  2. PREVIEW: Use --dry-run first to verify the payload and endpoint.
  3. CONFIRM: Display the full command and JSON body to the user.
  4. EXECUTE: Only run with --yes after receiving explicit user approval.

Usage Examples

1. Read-Only (Safe)

node {baseDir}/scripts/atlas-call.mjs GET groups/{groupId}/clusters

2. Create/Modify (RISKY - Require Approval)

node {baseDir}/scripts/atlas-call.mjs POST groups/{groupId}/clusters \
  --data '{"name":"DemoCluster", "providerSettings":{...}}' \
  --dry-run

Options

  • -d, --data <json>: Request body string (ensure proper JSON escaping).
  • -p, --params <json>: Query parameters.
  • --dry-run: Print the request details without executing (Recommended for verification).
  • --yes: Skip interactive confirmation (Use CAREFULLY).

Environment

Requires ATLAS_CLIENT_ID and ATLAS_CLIENT_SECRET to be set.

Core Categories

(Use catalog command to see the full list of 50+ categories)

  • Clusters / Cloud Backups
  • Projects / Organizations
  • Database Users / Custom Database Roles
  • Alerts / Alert Configurations
  • Monitoring and Logs / Events
  • Network Peering / Private Endpoint Services
  • Serverless Instances
  • Access Tracking / Auditing