feat: Add Atlas Local Tools (#632)

Co-authored-by: Jeroen Vervaeke <[email protected]>
Co-authored-by: Jeroen Vervaeke <[email protected]>
Co-authored-by: Melanija Cvetic <[email protected]>
Co-authored-by: Nikola Irinchev <[email protected]>

Author: 4 people

.github/workflows/code-health.yml

@@ -34,6 +34,9 @@ jobs:
         run: npm ci
       - name: Run tests
         run: npm test
+        env:
+          SKIP_ATLAS_TESTS: "true"
+          SKIP_ATLAS_LOCAL_TESTS: "true"
       - name: Upload test results
         if: always() && matrix.os == 'ubuntu-latest'
         uses: actions/upload-artifact@v4
@@ -59,19 +62,41 @@ jobs:
           MDB_MCP_API_CLIENT_ID: ${{ secrets.TEST_ATLAS_CLIENT_ID }}
           MDB_MCP_API_CLIENT_SECRET: ${{ secrets.TEST_ATLAS_CLIENT_SECRET }}
           MDB_MCP_API_BASE_URL: ${{ vars.TEST_ATLAS_BASE_URL }}
-        run: npm test -- tests/integration/tools/atlas
+        run: npm test -- tests/integration/tools/atlas/
       - name: Upload test results
         uses: actions/upload-artifact@v4
         if: always()
         with:
           name: atlas-test-results
           path: coverage/lcov.info
 
+  run-atlas-local-tests:
+    name: Run Atlas Local tests
+    if: github.event_name == 'push' || (github.event.pull_request.user.login != 'dependabot[bot]' && github.event.pull_request.head.repo.full_name == github.repository)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: package.json
+          cache: "npm"
+      - name: Install dependencies
+        run: npm ci
+      - name: Run tests
+        run: npm test -- tests/integration/tools/atlas-local/
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: atlas-local-test-results
+          path: coverage/lcov.info
+
   coverage:
     name: Report Coverage
     if: always() && (github.event_name == 'push' || (github.event.pull_request.user.login != 'dependabot[bot]' && github.event.pull_request.head.repo.full_name == github.repository))
     runs-on: ubuntu-latest
-    needs: [run-tests, run-atlas-tests]
+    needs: [run-tests, run-atlas-tests, run-atlas-local-tests]
     steps:
       - uses: actions/checkout@v5
       - uses: actions/setup-node@v6
@@ -90,6 +115,11 @@ jobs:
         with:
           name: atlas-test-results
           path: coverage/atlas
+      - name: Download atlas local test results
+        uses: actions/download-artifact@v5
+        with:
+          name: atlas-local-test-results
+          path: coverage/atlas-local
       - name: Merge coverage reports
         run: |
           npx -y [email protected] "coverage/*/lcov.info" "coverage/lcov.info"

README.md

@@ -296,6 +296,13 @@ npx -y mongodb-mcp-server@latest --transport http --httpHost=0.0.0.0 --httpPort=
 
 NOTE: atlas tools are only available when you set credentials on [configuration](#configuration) section.
 
+#### MongoDB Atlas Local Tools
+
+- `atlas-local-list-deployments` - Lists MongoDB Atlas Local deployments
+- `atlas-local-create-deployment` - Creates a MongoDB Atlas Local deployment
+- `atlas-local-connect-deployment` - Connects to a MongoDB Atlas Local deployment
+- `atlas-local-delete-deployment` - Deletes a MongoDB Atlas Local deployment
+
 #### MongoDB Database Tools
 
 - `connect` - Connect to a MongoDB instance

knip.json

@@ -7,5 +7,6 @@
     "eslint-rules/*.js"
   ],
   "ignore": ["tests/integration/fixtures/curl.mjs", "tests/vitest.d.ts"],
+  "ignoreDependencies": ["@mongodb-js/atlas-local"],
   "ignoreExportsUsedInFile": true
 }