Merge remote-tracking branch 'origin/main' into MCP-264

Author: blva

.github/workflows/prepare-release.yml

@@ -35,6 +35,11 @@ jobs:
         run: |
           echo "NEW_VERSION=$(npm version ${{ inputs.version }} --no-git-tag-version)" >> $GITHUB_OUTPUT
           npm run build:update-package-version
+
+      - name: Update server.json version and arguments
+        run: |
+          npm run generate:arguments
+
       - name: Create release PR
         uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # 7.0.8
         id: create-pr

.github/workflows/publish.yml

@@ -75,6 +75,7 @@ jobs:
     environment: Production
     permissions:
       contents: write
+      id-token: write
     needs:
       - check
     if: needs.check.outputs.VERSION_EXISTS == 'false'
@@ -95,8 +96,19 @@ jobs:
         run: npm publish --tag ${{ needs.check.outputs.RELEASE_CHANNEL }}
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
       - name: Publish git release
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
           gh release create ${{ needs.check.outputs.VERSION }} --title "${{ needs.check.outputs.VERSION }}" --generate-notes --target ${{ github.sha }} ${{ (needs.check.outputs.RELEASE_CHANNEL != 'latest' && '--prerelease') || ''}}
+
+      - name: Install MCP Publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+
+      - name: Login to MCP Registry
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish

Dockerfile

@@ -9,3 +9,4 @@ ENTRYPOINT ["mongodb-mcp-server"]
 LABEL maintainer="MongoDB Inc <[email protected]>"
 LABEL description="MongoDB MCP Server"
 LABEL version=${VERSION}
+LABEL io.modelcontextprotocol.server.name="io.github.mongodb-js/mongodb-mcp-server"

README.md

@@ -293,6 +293,7 @@ npx -y mongodb-mcp-server@latest --transport http --httpHost=0.0.0.0 --httpPort=
 - `atlas-list-db-users` - List MongoDB Atlas database users
 - `atlas-create-db-user` - Creates a MongoDB Atlas database user
 - `atlas-list-alerts` - List MongoDB Atlas Alerts for a Project
+- `atlas-get-performance-advisor` - Gets Atlas Performance Advisor recommendations (index suggestions, drop index suggestions, schema suggestions, slow query logs)
 
 NOTE: atlas tools are only available when you set credentials on [configuration](#configuration) section.
 
@@ -368,6 +369,7 @@ The MongoDB MCP Server can be configured using multiple methods, with the follow
 | `exportCleanupIntervalMs`              | `MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS`                | 120000                                                                      | Time in milliseconds between export cleanup cycles that remove expired export files.                                                                                                                    |
 | `atlasTemporaryDatabaseUserLifetimeMs` | `MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` | 14400000                                                                    | Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.                                             |
 | `voyageApiKey`                         | `MDB_VOYAGE_API_KEY`                                | <not set>                                                                   | API key for communicating with Voyage AI. Used for generating embeddings for Vector search.                                                                                                             |
+| `previewFeatures`                      | `MDB_MCP_PREVIEW_FEATURES`                          | `[]`                                                                        | An array of preview features to opt into.                                                                                                                                                               |
 
 #### Logger Options
 
@@ -489,6 +491,19 @@ You can disable telemetry using:
 
 > **💡 Platform Note:** For Windows users, see [Environment Variables](#environment-variables) for platform-specific instructions.
 
+#### Opting into Preview Features
+
+The MongoDB MCP Server may offer functionality that is still in development and may change in future releases. These features are considered "preview features" and are not enabled by default. Generally, these features are well tested, but may not offer the complete functionality we intend to provide in the final release or we'd like to gather feedback before making them generally available. To enable one or more preview features, use the `previewFeatures` configuration option.
+
+- For **environment variable** configuration, use a comma-separated string: `export MDB_MCP_PREVIEW_FEATURES="vectorSearch,feature1,feature2"`.
+- For **command-line argument** configuration, use a space-separated string: `--previewFeatures vectorSearch feature1 feature2`.
+
+List of available preview features:
+
+- `vectorSearch` - Enables tools or functionality related to Vector Search in MongoDB Atlas:
+  - Index management, such as creating, listing, and dropping vector search indexes.
+  - Querying collections using vector search capabilities. This requires a configured embedding model that will be used to generate vector representations of the query data.
+
 ### Atlas API Access
 
 To use the Atlas API tools, you'll need to create a service account in MongoDB Atlas:

package-lock.json

@@ -1,8 +1,9 @@
 {
   "name": "mongodb-mcp-server",
   "description": "MongoDB Model Context Protocol Server",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
+  "mcpName": "io.github.mongodb-js/mongodb-mcp-server",
   "exports": {
     ".": {
       "import": {
@@ -51,7 +52,8 @@
     "fix": "npm run fix:lint && npm run reformat",
     "fix:lint": "eslint . --fix",
     "reformat": "prettier --write .",
-    "generate": "./scripts/generate.sh",
+    "generate": "./scripts/generate.sh && npm run generate:arguments",
+    "generate:arguments": "tsx scripts/generateArguments.ts",
     "test": "vitest --project eslint-rules --project unit-and-integration --coverage",
     "pretest:accuracy": "npm run build",
     "test:accuracy": "sh ./scripts/accuracy/runAccuracyTests.sh",
@@ -64,7 +66,7 @@
     "@ai-sdk/google": "^2.0.23",
     "@ai-sdk/openai": "^2.0.52",
     "@eslint/js": "^9.34.0",
-    "@modelcontextprotocol/inspector": "^0.16.5",
+    "@modelcontextprotocol/inspector": "^0.17.1",
     "@mongodb-js/oidc-mock-provider": "^0.11.3",
     "@redocly/cli": "^2.0.8",
     "@types/express": "^5.0.3",