mongodb-mcp-server 0.2.0 → 0.3.1-prerelease.1

package/package.json

@@ -1,37 +1,59 @@
 {
   "name": "mongodb-mcp-server",
   "description": "MongoDB Model Context Protocol Server",
-  "version": "0.2.0",
-  "main": "dist/index.js",
+  "version": "0.3.1-prerelease.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/lib.d.ts",
+        "default": "./dist/esm/lib.js"
+      },
+      "require": {
+        "types": "./dist/cjs/lib.d.ts",
+        "default": "./dist/cjs/lib.js"
+      }
+    }
+  },
+  "main": "./dist/cjs/lib.js",
+  "types": "./dist/cjs/lib.d.ts",
   "author": "MongoDB <info@mongodb.com>",
   "homepage": "https://github.com/mongodb-js/mongodb-mcp-server",
   "repository": {
     "url": "https://github.com/mongodb-js/mongodb-mcp-server.git"
   },
   "bin": {
-    "mongodb-mcp-server": "dist/index.js"
+    "mongodb-mcp-server": "dist/esm/index.js"
   },
   "publishConfig": {
     "access": "public"
   },
-  "type": "module",
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "start": "node dist/index.js --transport http --loggers stderr mcp",
+    "start:stdio": "node dist/index.js --transport stdio --loggers stderr mcp",
     "prepare": "npm run build",
     "build:clean": "rm -rf dist",
-    "build:compile": "tsc --project tsconfig.build.json",
-    "build:chmod": "chmod +x dist/index.js",
-    "build": "npm run build:clean && npm run build:compile && npm run build:chmod",
-    "inspect": "npm run build && mcp-inspector -- dist/index.js",
+    "build:update-package-version": "tsx scripts/updatePackageVersion.ts",
+    "build:esm": "tsc --project tsconfig.esm.json",
+    "build:cjs": "tsc --project tsconfig.cjs.json",
+    "build:universal-package": "tsx scripts/createUniversalPackage.ts",
+    "build:chmod": "chmod +x dist/esm/index.js",
+    "build": "npm run build:clean && npm run build:esm && npm run build:cjs && npm run build:universal-package && npm run build:chmod",
+    "inspect": "npm run build && mcp-inspector -- dist/esm/index.js",
     "prettier": "prettier",
     "check": "npm run build && npm run check:types && npm run check:lint && npm run check:format",
     "check:lint": "eslint .",
     "check:format": "prettier -c .",
     "check:types": "tsc --noEmit --project tsconfig.json",
+    "fix": "npm run fix:lint && npm run reformat",
+    "fix:lint": "eslint . --fix",
     "reformat": "prettier --write .",
     "generate": "./scripts/generate.sh",
-    "test": "vitest --project unit-and-integration --coverage",
-    "pretest:accuracy": "npm run build:compile",
+    "test": "vitest --project eslint-rules --project unit-and-integration --coverage",
+    "pretest:accuracy": "npm run build",
     "test:accuracy": "sh ./scripts/accuracy/runAccuracyTests.sh"
   },
   "license": "Apache-2.0",
@@ -39,55 +61,67 @@
     "@ai-sdk/azure": "^1.3.24",
     "@ai-sdk/google": "^1.2.22",
     "@ai-sdk/openai": "^1.3.23",
-    "@eslint/js": "^9.30.1",
-    "@modelcontextprotocol/inspector": "^0.16.0",
-    "@redocly/cli": "^1.34.4",
-    "@types/express": "^5.0.1",
-    "@types/node": "^24.0.12",
+    "@eslint/js": "^9.34.0",
+    "@modelcontextprotocol/inspector": "^0.16.5",
+    "@mongodb-js/oidc-mock-provider": "^0.11.3",
+    "@redocly/cli": "^2.0.8",
+    "@types/express": "^5.0.3",
+    "@types/http-proxy": "^1.17.16",
+    "@types/node": "^24.3.0",
     "@types/proper-lockfile": "^4.1.4",
+    "@types/semver": "^7.7.0",
     "@types/simple-oauth2": "^5.0.7",
     "@types/yargs-parser": "^21.0.3",
     "@vitest/coverage-v8": "^3.2.4",
     "ai": "^4.3.17",
-    "eslint": "^9.30.1",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-prettier": "^5.5.1",
+    "duplexpair": "^1.0.2",
+    "eslint": "^9.34.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
     "globals": "^16.3.0",
     "mongodb-runner": "^5.9.2",
     "ollama-ai-provider": "^1.2.0",
     "openapi-types": "^12.1.3",
-    "openapi-typescript": "^7.8.0",
+    "openapi-typescript": "^7.9.1",
     "prettier": "^3.6.2",
     "proper-lockfile": "^4.1.2",
+    "semver": "^7.7.2",
     "simple-git": "^3.28.0",
-    "tsx": "^4.20.3",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.36.0",
-    "vitest": "^3.2.4",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.41.0",
     "uuid": "^11.1.0",
-    "yaml": "^2.8.0"
+    "vitest": "^3.2.4",
+    "yaml": "^2.8.1"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.15.0",
+    "@modelcontextprotocol/sdk": "^1.17.4",
     "@mongodb-js/device-id": "^0.3.1",
-    "@mongodb-js/devtools-connect": "^3.9.2",
-    "@mongosh/service-provider-node-driver": "^3.10.2",
+    "@mongodb-js/devtools-connect": "^3.9.3",
+    "@mongodb-js/devtools-proxy-support": "^0.5.2",
+    "@mongosh/arg-parser": "^3.14.0",
+    "@mongosh/service-provider-node-driver": "~3.12.0",
     "@vitest/eslint-plugin": "^1.3.4",
     "bson": "^6.10.4",
     "express": "^5.1.0",
     "lru-cache": "^11.1.0",
-    "mongodb": "^6.17.0",
+    "mongodb": "^6.19.0",
     "mongodb-connection-string-url": "^3.0.2",
     "mongodb-log-writer": "^2.4.1",
-    "mongodb-redact": "^1.1.8",
+    "mongodb-redact": "^1.2.0",
     "mongodb-schema": "^12.6.2",
+    "node-fetch": "^3.3.2",
     "node-machine-id": "1.1.12",
+    "oauth4webapi": "^3.8.0",
     "openapi-fetch": "^0.14.0",
-    "simple-oauth2": "^5.1.0",
+    "ts-levenshtein": "^1.0.7",
     "yargs-parser": "^22.0.0",
     "zod": "^3.25.76"
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >= 23.0.0"
+  },
+  "optionalDependencies": {
+    "kerberos": "^2.2.2"
   }
 }

package/.dockerignore

@@ -1,11 +0,0 @@
-dist
-node_modules
-.vscode
-.github
-.git
-# Environment variables
-.env
-
-tests
-coverage
-scripts

package/.github/CODEOWNERS

@@ -1 +0,0 @@
-*          @mongodb-js/mcp-server-developers

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,48 +0,0 @@
----
-name: "Bug Report"
-description: "Report a bug to help us improve."
-title: "[Bug]: "
-type: "Bug"
-body:
-  - type: markdown
-    attributes:
-      value: "Please fill out the following details to help us address the issue."
-  - type: textarea
-    id: version
-    attributes:
-      label: "Version"
-      description: "Please provide the version of the MCP Server where the bug occurred. (e.g., 0.1.0, main branch sha, etc.)"
-      placeholder: "e.g., 0.1.0"
-    validations:
-      required: true
-  - type: checkboxes
-    id: app
-    attributes:
-      label: "App"
-      description: "Select the app where the bug occurred."
-      options:
-        - label: Cursor
-        - label: Windsurf
-        - label: VSCode
-        - label: VSCode Insiders
-        - label: Claude Desktop
-        - label: Other
-  - type: checkboxes
-    id: affected_models
-    attributes:
-      label: "Affected Models (if applicable)"
-      description: "Select the models affected by the bug."
-      options:
-        - label: "Claude 3.5 Sonnet"
-        - label: "Claude 3.7 Sonnet"
-        - label: "GPT-4a"
-        - label: "o4-mini"
-        - label: "Other"
-  - type: textarea
-    id: description
-    attributes:
-      label: "Bug Description"
-      description: "Describe the bug in detail. Include steps to reproduce, expected behavior, and actual behavior."
-      placeholder: "e.g., When I prompt connect to mongodb, it crashes with error XYZ."
-    validations:
-      required: true

package/.github/dependabot.yml

@@ -1,10 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"

package/.github/pull_request_template.md

@@ -1,5 +0,0 @@
-## Proposed changes
-
-## Checklist
-
-- [ ] I have signed the [MongoDB CLA](https://www.mongodb.com/legal/contributor-agreement)

package/.github/workflows/accuracy-tests.yml

@@ -1,55 +0,0 @@
-name: Accuracy Tests
-
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - main
-  pull_request:
-    types:
-      - labeled
-
-jobs:
-  run-accuracy-tests:
-    name: Run Accuracy Tests
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-    if: |
-      github.event_name == 'workflow_dispatch' ||
-      (github.event_name == 'pull_request' && github.event.label.name == 'accuracy-tests')
-    env:
-      MDB_OPEN_AI_API_KEY: ${{ secrets.ACCURACY_OPEN_AI_API_KEY }}
-      MDB_GEMINI_API_KEY: ${{ secrets.ACCURACY_GEMINI_API_KEY }}
-      MDB_AZURE_OPEN_AI_API_KEY: ${{ secrets.ACCURACY_AZURE_OPEN_AI_API_KEY }}
-      MDB_AZURE_OPEN_AI_API_URL: ${{ vars.ACCURACY_AZURE_OPEN_AI_API_URL }}
-      MDB_ACCURACY_MDB_URL: ${{ secrets.ACCURACY_MDB_CONNECTION_STRING }}
-      MDB_ACCURACY_MDB_DB: ${{ vars.ACCURACY_MDB_DB }}
-      MDB_ACCURACY_MDB_COLLECTION: ${{ vars.ACCURACY_MDB_COLLECTION }}
-      MDB_ACCURACY_BASELINE_COMMIT: ${{ github.event.pull_request.base.sha || '' }}
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Run accuracy tests
-        run: npm run test:accuracy
-      - name: Upload accuracy test summary
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: accuracy-test-summary
-          path: .accuracy/test-summary.html
-      - name: Comment summary on PR
-        if: github.event_name == 'pull_request' && github.event.label.name == 'accuracy-tests'
-        uses: marocchino/sticky-pull-request-comment@d2ad0de260ae8b0235ce059e63f2949ba9e05943 # v2
-        with:
-          # Hides the previous comment and add a comment at the end
-          hide_and_recreate: true
-          hide_classify: "OUTDATED"
-          path: .accuracy/test-brief.md

package/.github/workflows/check-pr-title.yml

@@ -1,29 +0,0 @@
-name: "Check PR Title"
-on:
-  pull_request:
-    types:
-      [
-        opened,
-        synchronize,
-        reopened,
-        ready_for_review,
-        labeled,
-        unlabeled,
-        converted_to_draft,
-        edited,
-      ]
-
-permissions:
-  pull-requests: read # to read PR title and labels
-
-jobs:
-  check-pr-title:
-    name: Check PR Title
-    runs-on: ubuntu-latest
-    steps:
-      - name: Enforce conventional commit style
-        uses: realm/ci-actions/title-checker@d6cc8f067474759d38e6d24e272027b4c88bc0a9
-        with:
-          regex: '^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test|ops){1}(\([\w\-\.]+\))?(!)?: .*'
-          error-hint: 'Invalid PR title. Make sure it follows the conventional commit specification (i.e. "<type>(<optional scope>): <description>") or add the no-title-validation label'
-          ignore-labels: "no-title-validation"

package/.github/workflows/check.yml

@@ -1,58 +0,0 @@
----
-name: Checks
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-  pull_request_target:
-    branches:
-      - main
-
-permissions: {}
-
-jobs:
-  check-style:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Run style check
-        run: npm run check
-
-  check-generate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - run: npm run generate
-
-  check-dep:
-    name: Check dependencies
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies, build and remove dev dependencies
-        run: |
-          npm ci
-          rm -rf node_modules
-          npm pkg set scripts.prepare="exit 0"
-          npm install --omit=dev
-      - run: npx -y @modelcontextprotocol/inspector --cli --method tools/list -- node dist/index.js

package/.github/workflows/code_health.yaml

@@ -1,94 +0,0 @@
----
-name: Code Health
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-
-permissions: {}
-
-jobs:
-  run-tests:
-    name: Run MongoDB tests
-    if: github.event_name == 'push' || (github.event.pull_request.user.login != 'dependabot[bot]' && github.event.pull_request.head.repo.full_name == github.repository)
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-      fail-fast: false
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-        if: matrix.os != 'windows-latest'
-      - uses: actions/checkout@v4
-      - 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
-      - name: Upload test results
-        if: always() && matrix.os == 'ubuntu-latest'
-        uses: actions/upload-artifact@v4
-        with:
-          name: test-results
-          path: coverage/lcov.info
-
-  run-atlas-tests:
-    name: Run Atlas 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@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Run tests
-        env:
-          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 -- --exclude "tests/unit/**" --exclude "tests/integration/tools/mongodb/**" --exclude "tests/integration/*.ts"
-      - name: Upload test results
-        uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: atlas-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]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Download test results
-        uses: actions/download-artifact@v4
-        with:
-          name: test-results
-          path: coverage/mongodb
-      - name: Download atlas test results
-        uses: actions/download-artifact@v4
-        with:
-          name: atlas-test-results
-          path: coverage/atlas
-      - name: Merge coverage reports
-        run: |
-          npx -y lcov-result-merger@5.0.1 "coverage/*/lcov.info" "coverage/lcov.info"
-      - name: Coveralls GitHub Action
-        uses: coverallsapp/github-action@v2.3.6
-        with:
-          file: coverage/lcov.info

package/.github/workflows/code_health_fork.yaml

@@ -1,36 +0,0 @@
----
-name: Code Health (fork)
-on:
-  pull_request_target:
-    branches:
-      - main
-
-permissions: {}
-
-jobs:
-  run-tests:
-    name: Run MongoDB tests
-    if: github.event.pull_request.user.login == 'dependabot[bot]' || github.event.pull_request.head.repo.full_name != github.repository
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-      fail-fast: false
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-        if: matrix.os != 'windows-latest'
-      - uses: actions/checkout@v4
-      - 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
-      - name: Upload test results
-        if: always() && matrix.os == 'ubuntu-latest'
-        uses: actions/upload-artifact@v4
-        with:
-          name: test-results
-          path: coverage/lcov.info

package/.github/workflows/codeql.yml

@@ -1,34 +0,0 @@
-name: "CodeQL Advanced"
-
-on:
-  push:
-    branches: ["main"]
-  pull_request:
-    branches: ["main"]
-  schedule:
-    - cron: "35 4 * * 4"
-
-jobs:
-  analyze:
-    name: Analyze (${{ matrix.language }})
-    runs-on: ubuntu-latest
-    permissions:
-      security-events: write
-
-    strategy:
-      fail-fast: false
-      matrix:
-        language:
-          - actions
-          - javascript-typescript
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Initialize CodeQL
-        uses: github/codeql-action/init@v3
-        with:
-          languages: ${{ matrix.language }}
-      - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v3
-        with:
-          category: "/language:${{matrix.language}}"

package/.github/workflows/dependabot_pr.yaml

@@ -1,26 +0,0 @@
----
-name: Dependabot PR
-on:
-  pull_request:
-    types: [opened]
-    branches:
-      - main
-
-permissions: {}
-
-jobs:
-  merge-dependabot-pr:
-    name: Merge Dependabot PR
-    if: github.event.pull_request.user.login == 'dependabot[bot]'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: mongodb-js/devtools-shared/actions/setup-bot-token@main
-        id: app-token
-        with:
-          app-id: ${{ vars.DEVTOOLS_BOT_APP_ID }}
-          private-key: ${{ secrets.DEVTOOLS_BOT_PRIVATE_KEY }}
-      - name: Enable auto-merge for Dependabot PRs
-        run: gh pr merge --auto --squash "$PR_URL"
-        env:
-          PR_URL: ${{github.event.pull_request.html_url}}
-          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}

package/.github/workflows/docker.yaml

@@ -1,57 +0,0 @@
-name: Daily Release Docker Image
-on:
-  schedule:
-    - cron: "0 1 * * *" # Every day at 1:00 AM
-  workflow_dispatch: # Run the action manually
-permissions:
-  contents: read
-  issues: write
-jobs:
-  push:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-        with:
-          config: ${{ vars.PERMISSIONS_CONFIG }}
-      - name: Check out code
-        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435
-      - name: Login to Docker Hub
-        uses: docker/login-action@74a5d142397b4f367a81961eba4e8cd7edddf772
-        with:
-          username: "${{ secrets.DOCKERHUB_USERNAME }}"
-          password: "${{ secrets.DOCKERHUB_PASSWORD }}"
-      - name: Set date and version
-        id: set-properties
-        run: |
-          DATE=$(date +'%Y-%m-%d')
-          VERSION=$(npm pkg get version | tr -d '"')
-          echo "DATE=${DATE}" >> "$GITHUB_OUTPUT"
-          echo "VERSION=${VERSION}" >> "$GITHUB_OUTPUT"
-      - name: Build and push image to dockerhub registry
-        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83
-        with:
-          context: .
-          platforms: linux/amd64,linux/arm64
-          tags: ${{ vars.DOCKERHUB_IMAGE_REPOSITORY }}:latest, ${{ vars.DOCKERHUB_IMAGE_REPOSITORY }}:${{ steps.set-properties.outputs.VERSION }}, ${{ vars.DOCKERHUB_IMAGE_REPOSITORY }}:${{ steps.set-properties.outputs.VERSION }}-${{ steps.set-properties.outputs.DATE }}
-          file: Dockerfile
-          push: true
-          provenance: mode=max
-          sbom: true
-          build-args: |
-            VERSION=${{ steps.set-properties.outputs.VERSION }}
-      - uses: mongodb-js/devtools-shared/actions/setup-bot-token@main
-        id: app-token
-        if: ${{ failure() }}
-        with:
-          app-id: ${{ vars.DEVTOOLS_BOT_APP_ID }}
-          private-key: ${{ secrets.DEVTOOLS_BOT_PRIVATE_KEY }}
-      - name: Create Issue
-        if: ${{ failure() }}
-        uses: imjohnbo/issue-bot@572eed14422c4d6ca37e870f97e7da209422f5bd
-        with:
-          token: ${{ steps.app-token.outputs.token }}
-          title: Release Failure for Docker Image ${{ steps.set-properties.outputs.VERSION }}-${{ steps.set-properties.outputs.DATE }}
-          body: See https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
-          labels: "docker, release_failure"